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Introduction 



Welcome to the X Window System version 11 (XI 1 or X). The X Window 
System is a network transparent window system. 

The HP Visual User Environment (HP VUE) is a graphical user interface 
that is based on the X Window System. The X Window System can be run 
alone, or as part of HP VUE. This manual covers what is needed to run the X 
Window System by itself. 

In this chapter you'll find out how this manual is organized and some of the 
conventions it uses. 



Who Should Read this Manual 

The primary audience for this manual is system administrators for systems 
running the X Window System but not HP VUE. 

Since HP VUE provides other mechanisms for performing some of the actions 
covered in this manual, HP VUE users should first look in the HP Visual User 
Environment System Administration Manual^ Some information is common to 
both this manual and the HP Visual User Environment System Administration 
Manual. 
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How This Manual Is Organized 

Chapter 1 Introduction. Gives some tips, and describes other 

documentation available to you. 

Chapter 2 Hardware and software that are part of a typical Xll system 

and explains general concepts. 

Chapter 3 Configuration information for default file, multiple screens, 

remote operation, special input devices, Starbase applications, 
and Native Language support. 

Chapter 4 Starting, using, and stopping X. 

Chapter 5 How applications obtain resources. 

Chapter 6 How and where to use different fonts. 

Chapter 7 Motif Window Manager. 

Chapter 8 Xll clients. 

Chapter 9 Special mouse and keyboard configurations. 

Chapter 10 Printing and screen dumps. 

Chapter 11 Starbase graphics. 

Reference "man pages" — reference for X clients. 

Appendix B Using the Keyboards. 

Glossary Special terms. 
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Conventions 

As you read this manual, notice the following typographical conventions: 
Table 1-1. Typographical Conventions 



If you see ... 


It means . . . 


computer text 


This text is displayed by the computer or text that you type exactly 
as shown. For example, 

login: 

is a login prompt displayed by the computer. 


italic text 


A book title, emphasized text, or text that you supply. For example, 

hpterm -fg color 
means you type "hpterm -fg" followed by a color you choose. 


o 


You press the corresponding key on the keyboard. For example, 


(CTRL) (Left Shift] (Reset) 


means you hold down the tcTRL) key, the (Left Shift) key, and the 
(Reset) all at the same time. 


[ ] 


An optional parameter that can be left off if you don't need that 
functionality. For example, 

xload [-rv] & 

means that you must type "xload" but don't have to type "-rv" . 


{ } 


A list containing mutually exclusive optional parameters. For 
example, 

"'* "^ { o« } 

means that option r can be set to either on or off, but not both. 


bold text 


The definition of this term follows. Often the term is also defined in 
the glossary. 
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Also, you can use the X Window System with either a two- or a three-button 
mouse by observing the following conventions. These are the default mouse 
button settings and can be changed as described in chapter 9. 

Table 1-2. Mouse Buttons and Their Locations 



If you see . . . 


On a 2-button mouse press . . . 


On a 3-button mouse press . . . 


Button 1 


The left button. 


The left button. 


Button 2 


Both buttons simultaneously 


The middle button. 


Button 3 


The right button. 


The right button. 



Be careful of your spelling: 

■ Watch uppercase and lowercase letters. A file named .xdef aults is not the 
same file as .Xdef aults. Use uppercase letters where indicated and only 
where indicated. 

■ Don't confuse the number 1 (one) with the letter "1" (el). 

■ Don't confuse the "0" (zero) with the upper case "0" (oh). 

■ White space (extra spaces or tabs) at the end of a command line in a text 
file sometimes alters the meaning of the command. Files such as .rhosts are 
especially vulnerable. After modifying a file, check for unwanted white space. 
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For More Information 

Read these books to find out more about HP-UX, OSF/Motif, the X Window 
System, widgets, and widget programming: 

Title 



A Beginner's Guide to HP-UX 

A Beginner's Guide to Using Shells 

A Beginner's Guide to Text Editing 

OSF/1 System Administrator's Guide 

OSF/1 User's Guide 

Domain/OS System Administration Guide 

Using the X Window System on Apollo Workstations 

Printing in the Domain/OS Environment 

HP Visual User Environment User's Guide 

HP Visual User Environment System Administration 
Manual 

Finally, depending on your needs, the following books about the X Window 
System might prove useful: 

■ Introduction to the X Window System by Oliver Jones. Prentice Hall, 
Englewood Cliffs, NJ:1989. 

■ X Window System User's Guide by Tim O'Reilly and Valerie Querela. 
O'Reilly and Associates, Newton, MA: 1991. 



HP Part Number 

98594-90006 

98594-90008 

98594-90010 

B2151-90005 

B2151-90003 

19001-AOO 

015213-A02 

011774-A02 

B1171-90042 

B1171-90044 
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What is the X Window System? 

This chapter describes: 

■ Basic concepts. 

■ The hardware and software of a typical system. 

■ Distributed computing. 



Basic Concepts 

This section introduces several fundamental concepts: 

■ The role of the X server. 

■ Multi-tasking environments. 

■ Distributed computing. 

The Server-Client Interaction Model 

The server starts during system boot before the login screen is displayed. The 
server controls all access to input devices (typically the mouse and keyboard) 
and all access to output devices (typically the display). You can think of it 
as standing between the programs running on your system and your system's 
input and display devices. 
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Figure 2-1. The Server Controls Display Access. 

A client is any program written to run with the server. Clients know about 
windows and workspaces and how to make use of them. Non-clients are 
programs that don't know how to make use of windows. 

Multi-Tasking 

Multi-tasking is the computer's ability to execute several programs 
simultaneously. Each program is a separate task (process). Each process 
usually runs in a separate window, and processes running in separate windows 
do not interfere with one another. For example, you can have the system 
recalculate a large spreadsheet in one window while you shift your attention 
between editing a monthly report in a second window and answering your 
electronic mail in a third. Each program normally has a main window for 
visual interaction, and each window has its own input and output. 

Only one window at a time receives user input. That window is called the 
active window. While you focus on one window, other windows continue 
running unattended or wait for your input. 



2-2 What is the X Window System? 



Distributed Computing— Local and Remote Access 

Remote Access 

Networked computing environments provide the ability to run programs on 
computers other than the one you are sitting in front of. For example, you 
can run a program locally and display the output on the screen of a remote 
system. Conversely, you can run a program remotely and display the output 
in a window on your screen. You can also run a program remotely and have it 
display on yet another remote screen. 

The Distributed Computing Environment 

A Distributed Computing Environment (DCE) is a group of computer systems 
joined together into a network. Resources resident on one system are available 
to all systems. A LAN (Local Area Network) provides the link. 

Xll doesn't care where a program is — it simply communicates to the program 
via the LAN connection. This structure permits you to operate workstations at 
a strictly local level with all client programs residing locally, or at a networked 
level with some programs running locally and others running remotely. 

In addition, other systems on the LAN can run programs that reside on your 
workstation and direct the visual output to any screen on the network. 
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Figure 2-2. A Typical Distributed Computing Environment. 
Application Servers 

One of the workstations in figure 2-2 is an application server. An application 
server provides the processing power and memory necessary to run large 
processor-intensive applications. A user at one of the workstations can log into 
the application server to enter necessary data and run complex programs. The 
output can be directed to a window on the user's workstation. More than one 
user can run programs at the same time. 

Fiie Servers 

Another workstation in figure 2-2 is a file server. A file server controls the 
storage and retrieval of data from hard disks. The file server provides a 
central location for files, which means that less storage space is required on an 
individual's local computer. It also provides a relatively inexpensive and quick 
backup facility. 

A file server can also serve as a hub for diskless workstations. You can have 
a cluster of several diskless workstations connected to a single hub with a 
large disk. Each workstation, or node, needs a certain amount of individual 
space on the disk, but all nodes can share the system and application software, 
eliminating the need for redundant local system storage. 
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Print Servers 

One of the workstations in figure 2-2 has several printers attached to it and 
acts as a print server — a computer that controls spooling and other printing 
operations. Page formatters and page composition programs reside on the print 
server and are invoked with the proper commands. 

Graphics Stations 

Certain applications use graphics accelerators to speed up the presentation of 
graphics on the screen. Generally, engineers working with CAD (Computer- 
Aided Design) applications are the major users of graphics accelerators. 
Hewlett-Packard supports graphics acceleration with a graphics library called 
Starbase. The graphics station in figure 2-2 has two high-performance graphics 
subsystems attached to it. Each subsystem is powerful enough to run the X 
Window System while running a Starbase application. 

The graphics station permits a larger number of people to share the expensive 
hardware and software resources required by a CAD/CAM station. Tasks 
that engineers may have that do not require graphics acceleration can be 
accomplished at their desks on a more typical workstation. 

IMuiti-Vendor Communications 

DCE allows computers manufactured by different vendors, running different 
operating systems, to communicate with each other over the LAN. If you 
are using a computer made by Hewlett-Packard, you can communicate over 
the LAN directly with computers made by a variety of other manufacturers 
supporting X, as long as each is running the X Window System and connected 
to a LAN using the Ethernet protocol standard. 

HP Workstation IBM HP Workstation 



LAN 



DEC SUN 

Figure 2-3. ly/luiti-Vendor Communication. 
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The Parts of a Typical X11 System 

All Xll system have the following features in common: 

■ Computer hardware. 

■ The operating system. 

■ An X server program to control communication between the display and 
client programs. 

■ Client programs, including: 

a A window manager to control the display's window environment, 
n Application programs to provide useful services. 

Hardware 

The hardware system consists of several components: 

System Processing Unit (SPU) 

The SPU contains the logic circuitry that performs all the processing that 
takes place. The SPU runs the server, takes care of foreground and background 
processing, and controls local and remote accessing of your system's resources. 

The Hard Disk 

The hard disk stores programs and data files. Some configurations are called 
diskless clusters because groups of users share the same hard disk. 

Keyboard 

The keyboard is an input device used to type information into the computer. 
Although the keyboard is frequently used in conjunction with a mouse, it does 
not need to be. You can configure Xll so that you can use the keyboard for 
both text entry (its usual purpose) and for pointing and selecting (the mouse's 
usual purpose). Mouseless operation may be beneficial in situations where desk 
space is at a premium. 
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Note There are now two keyboards available for Hewlett-Packard 

I workstations, the 46021A keyboard, and the C1429A keyboard. 

|n See appendix B, Using the Keyboards, for more information on 

using these keyboards and the differences between them. 



Mouse and Other Pointing Devices 

A pointing device lets you point to a specific area on the screen and select it. 
A mouse is the most common pointing device. Mouse movements and button 
presses can be associated with keyboard key presses for mouseless operation. 

For the HP-UX and OSF/1 operating systems, the server supports other 
HP-HIL (Hewlett-Packard Human Interface Link) pointing devices — for 
example a digitizer tablet or track ball. References to mouse actions apply also 
to corresponding actions with other HP-HIL pointing devices. 

Display 

The display is the principal output device. A typical display consists of one 
physical screen per mouse and keyboard. However, a display can include as 
many as four physical screens, all using the same mouse and keyboard. 

The screen becomes the root window when you boot Xll. The root window 
contains all the windows, menus, and icons that comprise the visual elements of 
your Xll environment. 

Technically, the screen is known as a bitmapped device because the graphical 
elements (windows and icons) that it displays are stored by the computer as 
a bitmap, a pattern of bits (dots) that can be readily displayed as graphical 
images. 

Local Area Network (LAN) 

The LAN is composed of hardware and software. The hardware connects the 
computer system physically to a network that includes other computer systems 
at your site and could connect to other networks at different locations. The 
LAN enables you to take advantage of remote processing capabilities of Xll. 
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Software 

There are four types of software that comprise the X Window System. 

To an end-user, the layers blend together into a single working environment. 
However, from a system administration point of view, it is important to know 
how the layers work together. 

The Operating System 

The operating system is the software that controls the operation of the 
computer system. The X Window System runs on three Hewlett-Packard 
operating systems: HP-UX, OSF/1, and Domain/OS. These are multi-user, 
multi-tasking environments. A multi-user environment means more than one 
user can be on the system at the same time. A multi-tasking environment 
means that each of those users can run more than one program at a time. 

The X Server 

The central part of the X Window System is the server, also called the X 
server or display server. The server is the program that controls the screen, 
keyboard, and mouse, and processes communication requests. The server 
updates the windows on the screen as a client generates new information 
or as you enter information through an input device. All client programs 
communicate through the server. 

The Domain operating system has two X servers: 

■ Xapollo is the share mode server that shares the screen simultaneously with 
the Apollo Display Manager. It is described in Using the X Window System 
on Apollo Workstations (order number 015213- A02). 

■ Xdomain is the borrow mode server. This is the Domain/OS server described 
in this manual. It also runs with the Apollo Display Manager, but DM 
Windows and X Windows can't display at the same time. 

The Window lUlanager 

The window manager is your main means of dynamically controlling the size, 
shape, state (icon or normal), and location of the windows on your screen. It 
also supplies the frames and menus for the windows. 



2-8 What is the X Window System? 



The window manager is the first client started during a session after the X 
server has started. All other clients with their own windows must be able to 
interact with the window manager. 

This manual covers the OSF/Motif Window Manager (mwm). Using the window 
manager is covered in chapter 4. Configuring the window manager is covered in 
chapter 7. 





\:U 



MdaUSQSBL 



I'J i^i^ifflfij 



Dear Mi 



Just got the latest report on your last quarter's 
activities. Sure looks good to ne. 



Congratulations, 
The Bos| 

Mot HhW 

Nmi tfindau 

Start Clock 

Start Load 

X Shuffle Doun 






local 



(owac»aiipq liptorw 






Shuff 18 Up 

Refrosh 

itestart 



Figure 2-4. Windows, Clients, IMenus, and Icons 
X Clients 

Clients are programs designed to run under the X Window System. 

There are a number of clients that are included with the X Window System. 
For example, the bitmap client lets you design and store custom bitmaps. The 
xrdb client provides the ability to view and modify current resources. 

Some clients (for example, xwininf o and xmodmap) do not create windows. 
They use an existing terminal emulation window to display their output. 



What is the X Window System? 2-9 



2 



Clients are discussed in chapter 8. 

Non-Client Programs 

Non- client programs are designed to run alone on display screens or 
"terminals" and are therefore referred to as terminal-based programs. 
Terminal-based programs must have terminal emulator windows created for 
them so that they can run in a window environment. 
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Preliminary Configuration 



This chapter covers some of the preliminary configuration you may need to do 
before starting the X server. It includes: 

■ Setting the DISPLAY environment variable. 

■ Using hardware and software configuration files. 

■ Using custom screen configurations. 

■ Configuring the system for special input devices. 

■ Distributed processing. 

■ Using Native Language Support. 

There are other chapters that deal with initial configuration for special 
situations: 

■ Chapter 4 covers starting and running X. 

■ Chapter 7 covers configuring the window manager. 

■ Chapter 11 covers configuration for running the X Window System with 
Starbase. 
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Do You Need to Read This Chapter? 

All users should check: 

■ the DISPLAY variable. 

■ the XO. hosts file. 

■ the /etc/hosts file if your system is not configured to query a nameserver. 

OSF/1 and Domain/ OS users should read the next section, "Finding Your 
System Directory" for information about directories and file locations. 

The rest of this chapter covers optional configuration. The following table 
shows the assumed configuration, and what you should read if you want to 
change it. 

Table 3-1. Standard X Configuration 



Expected configuration 


If you want to change it, read . . . 


1 display 


"Using Custom Screen Configurations" 


1 mouse 


"Using Special Input Devices" 


1 keyboard 


"Using Special Input Devices" 


American English language 


"Customizing for Native Language 
Support" 


For HP-UX, X starts the hpterm and mwm 

clients as part of its own start-up 

procedures. 

For OSF/1 and Domain/OS systems, X 

starts the xterm and mwm clients as part of 

its own start-up procedures. 


"Software Configuration Files" 
chapter 4 


Default mwm colors, window decorations, 
and menus. 


"Software Configuration Files" 
chapter 5 
chapter 7 
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Finding Your System Directory 

The operating systems have slightly different directory structures. The 
directory containing most of the X Window System is called the system 
directory. 





Table 3-2. 


System Directory 


Opera 


ting System 


System Directory 


HP-UX 




/usr/lib/Xll 


OSF/1 




/usr/Xll/lib 


Domain/OS 




/usr/Xll/lib 



This document uses the HP-UX paths, as does most general purpose X 
documentation. 

On OSF/1 and Domain/OS systems, links are established between the HP-UX 
directory names and their corresponding OSF/1 and Domain/ OS directory 
names. You can specify the HP-UX file path and have the links automatically 
connect you with the right path on your system. 
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Table 3-3. OSF/1 and Domain/OS Symbolic Links 


Use . . . 


to refer to . . . 


Directories 


/usr/lib/Xll 


/usr/Xll/lib 


/usr/bin/Xll 


/usr/Xll/bin 


/usr/ include (Domain/OS) 


/usr/Xl 1/ include 


/usr/include/XllR4 (OSF/1) 


/usr/Xl 1/include/Xl 1R4 


/usr/ include/Mot if 1.1 (OSF/1) 


/usr/Xll/include/Motif 1 . 1 


Files 


/usr/bin/xllstart 


/usr/Xl 1/bin/xllstart 


/usr/bin/stconv' 


/usr/Xl 1/bin/stconv 


/usr/bin/stload 


/usr/Xl 1/bin/stload 


/usr /b in/ s tmkf ont 


/usr/Xl 1/bin/stmkf ont 


/usr/bin/stlicense 


/usr/Xl 1/bin/stmkf ont 


/usr/bin/stmkdirs 


/usr/Xl 1/bin/stmkdirs 



You may wish to set up other links yourself. 

For example, on an OSF/1 system, you could see the contents of your system 
directory by entering either: 

cd /usr/lib/Xll 
Is 



or 



cd /usr/Xll/lib. 
Is 
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Note The Domain/ OS links are to your node entry directory. If you 

I want the contents of a remote node directory, you must enter 

WA the specfic Domain/OS path to that directory. For example: 

Assume you are on system //bar. 

Using Domain/ OS path names, if you type . . . 

cd //foo/usr/Xll/lib 
pwd 

. , . then the sytem responds with . . . 

//foo/usr/Xll/lib 

But using HP-UX path names, if you type . . . 

cd //foo/usr/lib/Xll 
pwd 

you get ... 

//bar/xsr/Xll/lib 



Setting the DISPLAY Variable 

The DISPLAY environment variable establishes the host, display number, and 
screen number to which a system sends bitmapped output. 

You can check the current setting of your system's DISPLAY variable by typing 
the appropriate command from the following table: 

Table 3-4. Checking the DISPLAY Variable 



Operating System 


Command 


HP-UX 
OSF/1 
Domain/OS SysV 


env 


Domain/OS BSD 


print env 


Domain/OS Aegis 


Ivau: 



Preliminary Configuration 3-5 



A list similar to the following is displayed: 

DISPLAY=hpaaaaa : . 

HOME=/users/ellen 

TZ=PST8PDT 



The DISPLAY variable has the syntax: 



' hostname ' 
local 
Unix 
shmlink 



: displayf.screen] 



The default is hostname :0.0, which is display 0, screen of the display 
running the X server, (shmlink is not supported on Domain/OS.) 

To reset the DISPLAY environment variable type the appropriate command 
shown below, or put it into the configuration file used by your system if you 
want it to be in effect every time you log in. 





Table 3-5. Setting Environment Variables 


SheU 


Coimnand 


Configuration File 


sh 


DlSPLkY=host:display. screen 
export DISPLAY 


~/. prof lie 


csh 


setenv DISPLAY host.display. screen 


"/.login 


Aegis 
(Domain/OS) 


DISPLAY := host .display, screen 
export DISPLAY 


" /us er_dat a/ s t art up_din . xrr 
or 
/sys/dm/startup_login. xxx 


ksh 


lilS?LkY=host:display. screen 
export DISPLAY 


"/.profile 
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Making an XO.hosts File 

The /etc/XO. hosts file is an ASCII text file containing the hostnames of each 
remote host permitted to access your local server. 

■ If you are running as a stand-alone system, you must have your system's 
name in this file. 

■ If you are part of a network, the other system names must be included. 

The syntax is as follows: 

host 
host 
host 

For example, if you are hpaaaaa, and regularly ran clients on hpccccc, and 
hpddddd, you would want the following lines. 

hpaaaaa 
hpccccc 
hpddddd 

Note that aliases work as well as hostnames, provided they are valid, that is, 
commonly known across the network. 

The default screen configuration file XOscreens uses the default Xll remote 
host file XO.hosts. 

Note The OSF/1 and Domain operating systems use only XO.hosts, 

not custom X*. hosts or custom X*scrGGns files. 
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Each custom X*screens file is associated with a special X*. hosts file. The 
number represented by the * causes the correct screen and host files to be used 
together. For example, X3screens takes an X3. hosts file. Both are referenced 
by the server when it is started with a /usr/bin/Xll/X :3 command. 

If you use a special X*screens file, you need to set your DISPLAY variable 
appropriately. For the previous example, it would be set to hostname: 3.0. 
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Using an /etc/hosts File 

This file need not be present if your system is configured to query a 
nameserver. 

The /etc/hosts file is an ASCII text file containing a list of all the host names 
and internet addresses known to your system, including your own system. 

If your system is not connected to a network, use the loopback address 
( 127 .0.0.1) and the host name unknown: 

127 .0.0.1 unknown 

For a local system to access a remote host: 

■ The address and hostname of the romote host must be listed in the local 
system's /etc/hosts file. 

■ The user must have a valid login (username and password) and home 
directory on the remote host. 
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Software Configuration Files 

The X Window System uses four configuration files: 

• Xdef aults Specified default appearance and behavior 

characteristics for clients. The contents of this file are 
covered in more detail in chapter 5. 

.xllstart Specifies the clients that start when the X Window 

System starts. This file is covered in more detail in 
chapter 4. 

.mwmrc Specifies the menus, menu selections, button bindings, 

and keyboard bindings that control the OSF/Motif 
Window Manager (mwm). The contents of this file are 
discussed in chapters 5 and 7 

app-def aults/* Optional configuration for specific clients. The contents 

of this file are discussed in chapter 5. 

If your home directory does not contain these files, the X Window System uses 
the system- wide versions of these files in your system directory: 

sys. xllstart 

system. mwmrc 

If you want to customize your X environment, copy these files from the system 
directory to your home directory (noting the name change), and make your 
modifications. For example: 

cp /usr/lib/Xll/sys. mwmrc $HOME/. mwmrc 

cp /usr/lib/Xll/sys. Xdef aults $HOME/. Xdef aults 

The X server looks first in your home directory for these files. If they are not 
there, it uses the system-wide files. 
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Using Custom Screen Configurations 



Note Domain/ OS does not use the screen configuration files 

XOscreens or X^screens. 
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The default screen configuration is specified in the XOscreens file in your 
system directory. It assumes: 

■ There is one display — display 0. 

■ There is one screen — screen 0. 

■ The screen uses only one set of pixel planes (the image planes). 

■ The-screen is at the address node specified by /dev/crt. 

If you use some configuration other than the default, you must edit the default 
screen file or add additional screen configuration files. 

There should be a separate X* screens file for each display, where * is a 
number that matches the display number used when starting the X server. 

Creating a Custom 'XOscreens' File 

There are two ways to create a custom screen configuration for a display: 

■ You can modify XOscreens so that it contains device information for all the 
screen configurations you may want to use. This is generally the preferred 
way. Only one configuration is used at a time; the others are commented out. 
To switch from one screen configuration to another, you uncomment some 
lines and comment others. For multiple displays, you would have a separate 
file for each display — for example, Xlscreens for display 1. 

■ You can have a separate X*screens file for each screen configuration on a 
particular display. Switching between them involves modifying the command 
that starts the X server. 
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Screen Modes 

The syntax of the lines in X*screens depends on the screen mode you choose. 
Depending on your system's hardware, you may choose from four screen modes: 



image mode 



overlay mode 



stacked mode 



combined 
mode 



The default screen mode using multiple image planes for a 
single screen. The number of planes determines the variety of 
colors available to the screen. 

An alternate screen mode using overlay planes for a single 
screen. Overlay planes provide an alternate (auxiliary) set of 
planes to the standard image planes. You can see what is in 
the image planes only if you open a "transparent" window in 
the overlay plane and move the window over what you want 
to see. Typically, overlay planes are used in conjunction with 
image planes in either stacked mode or combined mode. 

A combination of image and overlay planes in which a single 
display has two "logical" screens: image planes and overlay 
planes. You move between the image and overlay planes by 
moving the pointer to the edge of the display. 

A combination of image and overlay planes in which a single 
display has a single screen that is a combination of the 
image and overlay planes. Typically, Starbase and other 
display-intensive applications run in image-plane windows 
that can be moved and resized like any other window, but the 
window frames are maintained in the overlay planes. 
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Table 3-6. Display Hardware and Screen Modes 



With this 
display hardware . . . 


You can use these modes . . . 




Image 


Overlay 


stacked 


Combined 


HP A1096 


y 








HP A1416 


V 


V 


y 




HP A1439 


y 








HP A1659 


y 








HP A1924 


y 








HP 9000S300 
model 425e 


y 








HP 9000S700 
model 710 


y 








HP 98542A 


y 








HP 98543A 


V 








HP 98544B 


V 








HP 98545A 


^ 








HP 98547A 


y 








HP 98548A 


y 








HP 98549A 


y 








HP 98550A 


V 


y 


y 




HP 98704A 


V 


>/ 




V^ 


HP 98720A 


>/ 


V 


>/ 




HP 98730A 


V 


V 


%/ 


V 


HP 98735A 


>/ 


y 




y 


HP 98765 


V 


>/ 


y 
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Syntax of 'X*screens' 

Each line in X+screens lists a separate screen device (except in combined 
mode). A screen device can be a physical device, the CRT screen, or the image 
planes or overlay planes of a physical device. 

The syntax for each line of an X*screens file is: 



/dev/cfemce 



depth 



{?.}! 



doublebuffer] 



^ depth 16 doublebuffer 
eonitorsize number 



[# comment] 



/dew /device Specifies the name of the device file that the X server should 
read for this display. 

depth Specifies the number of image and overlay planes available to 

the server (one pixel per plane). 

doublebuffer Specifies double buffer. Double buffering divides video memory 
into halves and displays one half while drawing the other. 
Double buffering is used with graphics programs that double 
buffer their screen output. This avoids "flashing" during screen 
redraw. 

depth 16 Specifies the division of the image planes into two 8-bit, double 

doublebuffer buffered halves. 

monitorsize Specifies the size of the monitor in inches (when nwm6er<100) 
or millimeters (when nwm6er>100). 

Example 

This example shows how to specify a particular screen configuration 
consisting of a high-resolution screen on which you want to run XI 1 and 
Starbase applications. The image plane of this screen is accessed by the 
device file / dev / image^device The overlay plane is accessed by the device 
file /dev/ overlay-device. You want to switch between four different screen 
configurations: 
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■ One screen with XI 1 running in the image planes (image mode). 

■ Two screens with Starbase running in the image planes and Xll running 
in the overlay planes (overlay mode). You may have only one Starbase 
application running in this mode, and you can see it only if you open a 
"transparent" window to look through the overlay planes. 

■ Two screens running on the same display (stacked mode). One screen runs 
in the image planes, and the other runs in the overlay planes. You move 
between the two screens by moving the pointer to the edge of the display. 
The order in which the screens appear is specified by the order in which their 
designations appear in the X+screens file. Starbase is not normally run in 
this mode. 

■ One screen with two visuals, one with depth 24, and the other with depth 
8 (combined mode). Starbase applications are run in windows that can be 
moved or resized like any other window. You can have several Starbase 
applications running at once, each in its own window. The order in which the 
screens are described is unimportant. 

Here is the XO sere ens file that creates these four configurations. To use a 
particular configuration, uncomment the line (two lines for Stacked Screens 
Mode) that create it, and make sure all other lines are commented. 

### Default Configuration ### 
/ dQW / image-device 

### Overlay Screens Mode ### 

# /dev/ overlay -device 

### Stacked Screens Mode ### 

# / dev / image-device 

# /dev/ overlay -device 

### Combined Screens Mode ### 

# /dev/ image-device / dev / overlay-device depth 24 depth 8 

More examples can be found in the system XOscreens file. Note that the first 
configuration is the default screen configuration provided with Xll. 
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Multiple Screen Configurations 

On systems that support multiple display devices, it is possible to configure X 
to use these multiple devices in two ways: 

■ A single X server can treat multiple devices as individual screens within a 
single display. 

Configure the X*scrGGns file so that each device is listed on a separate line. 
The order of the lines in the file determines the number given to each screen, 
beginning with zero. 

/dev/crtO #display 0, screen 

/dev/crtl #display 0, screen 1 

To address a specific device, use the screen parameter of the DISPLAY 
variable. For instance, DISPLAY=local:0. 1 addresses the second device. 

■ Multiple X servers can treat each device as a separate display. 

Create an X*screens file for each device. For example: 
XOscreens: 

/dev/crtO #display 0, screen 

Xlscreens: 

/dev/crtl #display 1, screen 

To address a specific device, use the display parameter of the DISPLAY 
variable. In this case, DISPLAY=local:1.0 addresses the second device. 

Mouse Tracking witli Multiple Screen Devices 

The mouse pointer tracks from left to right. For multiple- screen configuration 
files, the order of entry determines the tracking order of the mouse pointer. 
The first line in the file is the device on which the pointer appears when you 
start Xll. 

Other lines correspond to the screens that appear when the mouse is moved 
to the right or left side of the current screen. Moving off" the right side goes 
to the next higher display, the left side the to next lower. If you are on the 
highest display and move right, you move to the lowest display. If you are on 
the lowest display and move left, you move to the highest display. 
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Making a Device Driver File 

Devices specified in screen configuration files must correspond to device files. If 
you don't have the appropriate device file, you must create it using the mknod 
command. For information on mknod see the system, administration manual for 
your operating system. 
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Using Special Input Devices 

The X server reads an input device file, XOdevices in your system directory, to 
find out what input devices it should open and attach to the display. 

The Default 'XOdevices' File 

The default XOdevices file contains lines of text, but does not specify any 
input configuration. Rather, it assumes the default input configuration of one 
keyboard and one pointer. 

If this is your configuration, you may not want to change the contents of the 
file for three reasons: 

■ Clients can request and receive the services of an input device regardless of 
whether the device is specified in a device configuration file. Thus, you need 
not change the XOdevices file, or create a custom file, even though you have 
a custom input configuration. 

■ Non-clients (terminal-based programs) such as Starbase cannot receive 
the services of an input device if the device is specified in the device 
configuration file. Any device in the device configuration file is opened for 
use by the X server. Thus, changing the XOdevices file or creating a custom 
file to inform the server about a certain input device may interfere with a 
non-client's ability to access the device. 

■ Even if you have other screen configurations, you can rely on the default 
input device configuration without having to create an X*devices file to 
match every X*screens file. For example, if you had a custom X*screens 
file, you would not necessarily need an X*devices file. 

A custom X*devices file is required only when you want to tell the X server 
about a custom input device configuration. 

Note The OSF/1 operating system uses only the XOdevices file. You 

can modify it as described below. 
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How the Server Chooses the Default Keyboard and Pointer 

HP-UX and OSF/1 Systems 

Input devices attach to HP-UX and OSF/1 computers through an interface 
known as the Hewlett-Packard Human Interface Link (HP-HIL). Up to seven 
input devices can be attached to each HP-HIL. However, if the X*devices file 
does not exist, or does not specify otherwise, the X server recognizes only two 
devices: a pointer and a keyboard (clients, however, may still recognize other 
input devices). 

The X server uses the following order when choosing a pointer or keyboard: 

1. If the X*devices file specifies an input device as the pointer or keyboard, 
the X server uses that device as specified. 

2. If X*devices makes no specification, or there is no X*dGvices file, the X 
server takes the last mouse on the HP-HIL (the mouse farthest on the link 
from the computer) as the pointer and the last keyboard (the keyboard 
farthest on the link from the computer) as the keyboard. 

3. If the X server can open no mouse, it takes the last pointer device (knob 
box, graphics tablet, trackball, or touchscreen) on the HP-HIL as the 
pointer. 

4. If the X server can open no pointer device, it takes the last keyboard on the 
HP-HIL as the pointer as well as the keyboard. 

5. If the X server can open no keyboard, it takes the last key device 
(buttonbox, barcode reader) on the HP-HIL as the keyboard. 

6. If no pointer and keyboard can be opened, the server will not run, unless 
it is explicitly instructed to run without a keyboard or pointer by the 
X*devices file. 

Domain/OS Systems 

The Domain/OS borrow mode server (Xdomain) allows client programs to 
receive input from a supported set of input devices that are attached to the 
computer via a serial (RS-232) interface. The supported serial devices are 
listed in the sample XOdevices file in your system directory. 
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For example, assume an Apollo Lighted Programm^able Function Keyboard is 
attached to the computer via the first serial port. It is an extra input device 
that client programs access through protocol requests defined by the X input 
extensions. It can be identified to the X server by adding the following lines to 
the X*devices file. 

Begin_Device_Description 
Name Apollo.LPFK 
Path /dev/siol 
Use Extension 
End_Device_Description 

Creating a Custom 'X*clevices' File 

At some point, you may want to instruct the server to open a particular device 
as the keyboard or pointer or have the server open another input device as an 
extension of the keyboard or pointer. Additional devices with keys are treated 
as extensions to the keyboard; additional devices that point are treated as 
extensions to the pointer. 

To tell the server about a non-default input device configuration, you must 
add a device specification line to the appropriate X*devices. For example, 
you would use XOdevices if you used XOscreens and X2devices if you used 
X2screens. 

Syntax for Device Type and Relative Position 

The HP-UX and OSF/1 operating systems can refer to a device by its location 
on the HP-HIL. This syntax uses device type and relative position on the 
HP-HIL to specify input devices. Separate the part of your entry with tabs or 
spaces. 

relativeposition devicetype use [# comments] 



relativeposition Specifies the position of a device on the HP-HIL relative to 
other input devices of the same kind. 

devicetype Specifies the type of input device. 
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use Specifies whether the device is the keyboard, the pointer, or 

has some other use. 

Valid positions, types, uses, and examples are in the section "Selecting Values 
for 'X*devices' Files" in this chapter. 

Separate the parts of your entry with tabs or spaces. 

The position of an input device on the HP-HIL is relative to other devices of 
that type. Thus, first means the device connected closest to the computer on 
the HP-HIL of any device of that type. 

This syntax is most useful for systems running a single X server with no other 
programs directly opening input devices. Here, if you add a new input device 
to the HP-HIL, you don't have to edit the X*devices file unless the device is 
of the same type as one already named in the file and you add the new device 
ahead of that existing device. 

This syntax may become ambiguous when more than one X server is running 
on the same system or when non-client programs directly access input devices. 
This is because first actually means first device of that type available to the 
server. Thus, a device may be physically first on the HP-HIL, but not first for 
the server if the device is unavailable because it is currently being used by some 
other program. 

Syntax for Device File Name 

This syntax uses the device file name to specify input devices: 

/path/devicefile use [# comments^ 



/path/devicefile Specifies the path and device file to use as the input device. 

use Specifies whether the device is the keyboard, the pointer, or 

has some other use. 

This syntax is unambiguous when several X servers are running on the same 
computer or when non-client programs directly access the input device. 
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The Syntax for Reconfiguring the Path to Device Files 

The default path to the device files is /dev/hil, but you can specify another 
path if you choose. Also, if you have more than one HP-HIL, you can specify 
which HP-HIL the server should use. 

The syntax is: 

pai/i hil.path [# comments] 

path Specifies the path to the device files. 

The X server appends numbers to the path to create the names that it 
attempts to open for use as input devices. For example, specifying 

/tmp/foo hil.path 

results in the device names /tmp/f ool, /tmp/f oo2, and so on. 

Selecting Values for 'X*devices' Files 

X*devices files use the following special names for positions, devices, and uses: 
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Table 3-7. Values for *X*devices' 


Files. 


Positions 


Device Type (Device Class) 


Uses 


first 


keyboard (keyboard) 


keyboard 


second 


mouse (pointer) 


pointer 


third 


tablet (pointer) 


other 


fourth 


buttonbox (keyboard) 




fifth 


barcode (keyboard) 




sixth 


one_knob (pointer) 




seventh 


nine_knob (pointer) 
quadrature (pointer) 
touchscreen (pointer) 
trackball (pointer) 
null 





The nine-knob box appears to the X server as three separate input devices. 
Each row of knobs is a separate device with the first device being the bottom 
row. 

Note also that the HP barcode reader has two modes: keyboard and ASCII. 
The modes are set via switches on the reader. If you set the barcode reader to 
ASCII transmission mode, it appears to the server as a barcode reader and the 
device name is therefore barcode. However, if you set the barcode reader to 
emulate a keyboard, the barcode reader appears as a keyboard and the device 
name should therefore be keyboard. What distinguishes a barcode reader set 
to keyboard mode from a real keyboard is the relative position or the device 
file name, depending on which syntax you use. 

Similar to the barcode reader, the trackball appears to the server, not as a 
trackball, but as a mouse. Therefore, to specify a trackball, use the mouse 
device name. Again, what specifies the trackball instead of the real mouse is 
the relative position or the device filename, depending on which syntax you 
use. 
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Examples 

You can create a system on which the X server runs, but which does not have 
any input devices. In this case, clients could be run from a remote terminal, 
or from a remote host, and their output directed to the X server. To create a 
system with no input, include the following lines in the XOdevices file: 

first null keyboard 
first null pointer 

If you had a more complicated configuration, such as two graphics tablets, two 
keyboards, and a barcode reader, your X*devices file could look like this: 

first tablet pointer The pointer. 

second tablet other An extension of the pointer. 

first keyboard other An extension of the keyboard. 

second keyboard keyboard The keyboard. 

first barcode other An extension of the keyboard. 

In this example, the first tablet acts as the pointer, the second keyboard acts 
as the keyboard, the second tablet acts as an extension to the first, the first 
keyboard acts as an extension to the second, and the barcode reader acts as a 
second extension to the keyboard. 

Note that the barcode reader is in ASCII mode in this example. If the barcode 
reader were in keyboard mode, the last line of the example should read as 
follows: 

third keyboard other 

More examples can be found in the XOdevices file in /usr/Xll/newconf ig for 
OSF/1, etc/newconf ig for HP-UX, or your system directory for Domain/OS. 
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Customizing for Native Language Support (NLS) 

This section covers: 

■ How X uses the LANG environment variable and other environment variables. 

■ Accessing language-dependent message catalogs and resource files. 

■ Remote execution in NLS systems. 

NotG This section does not apply to the OSF/1 operating system. 



4 



Setting the LANG Environment Variable 

The LANG environment variable must be set in order to use native language 
support. Setting LANG causes X to use the language- sensitive routines for 
character handling. 

You can set LANG to any value in the /usr/lib/nls/conf ig file. The X 
Window System does not currently support the arable or hebrew languages. 
The message catalogs are located in subdirectories of /usr/lib/nls. 

The LANG environment variable is set in the same way as the DISPLAY 
environment variable discussed earlier in this chapter. 
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Table 3-8. Supported Languages 



american 


american.iso8859 1 


bulgarian 


C 


c-french 


c-french.iso88591 


chinese-s 


chinese-t 


Czech 


danish 


danish.iso88591 


dutch 


dutch.iso88591 


english 


english.iso88591 


finnish 


finnish.iso88591 


french 


french. iso88591 


german 


german.iso88591 


hungarian 


icelandic 


icelandic.iso88591 


Italian 


itaUan.iso88591 


Japanese 


japanese.ujis 


katakana 


korean 


norwegian 


norwegian. iso88591 


polish 


Portuguese 


portuguese.iso88591 


rumanian 


russian 


serbocroatian 


Spanish 


Spanish. iso88591 


Swedish 


swedish.iso88591 







No suffix on the language name implies HP romanS coding. 

Other NLS Environment Variables 

This section covers other NLS environment variables. It provides an overview 
only. For detailed information, refer to X Toolkit Intrinsics Programming 
Manual. 

Message Catalogs— The NLSPATH Environment Variable 

The NLSPATH environment variable determines the paths applications search 
for NLS message catalogs. X clients place NLS message catalogs in the 
/usr/lib/nls/$LANG directories. Both LANG and NLSPATH must be set in order 
to use those message catalogs. 

It shouldn't be necessary to set this variable unless the message catalogs are 
installed in non-standard locations. 

The proper value of NLSPATH depends on whether message catalogs exist for the 
current value of LANG. 
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To use the message catalogs for the language to which LANG is set, set NLSPATH 
to: 

/usr/lib/nls/msg/y,L/y.N . cat : /usr/lib/nls/C/XN . cat : $NLSPATH 

Setting the XUSERFILESEARCHPATH Environment Variable 

The XUSERFILESEARCHPATH environment variable controls where X applications 
look for their app-def aults resource files. The default location is in directory 
/usr/lib/Xll/app-defaults. You need to set XUSERFILESEARCHPATH if your 
resource files are not in this location. 

For example, to use Japanese app-def aults you would set 
XUSERFILESEARCHPATH to /usr/lib/Xll/japanese/app-def aults. 
Or, you could set XAPPLRESDIR to /usr/lib/Xll/'/L/app-def aults and LANG 
to "Japanese". If LANG is not set, '/.L defaults to null. 

If you set XUSERFILESEARCHPATH in $HOME/.prof ile, the value applies to all X 
clients you run. Non-clients will not find their resource files unless you link or 
copy them into the directory specified by XUSERFILESEARCHPATH. 

Setting tlie KBD_LANG Environment Variable 

X allows you to override the physical keyboard attaches to the HP-HIL. 

This variable can be set after the server has started. The NLIO processes for 
Asian users start only when either the physical keyboard is Asian or KBD.LANG 
is set to an Asian language. 

It should be necessary to set this variable only for those languages whose 
characters cannot be generated from the keyboard. For example, all HP 
romanS or iso8859.1 characters can be generated by any western European 
keyboard. But to generate Japanese characters from a U.S. keyboard, you must 
set KBD.LANG to Japanese. 
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Language-Dependent Bitmaps— the XBMLANGPATH Variable 

The XBMLANGPATH variable specifies the search path for language-dependent 
bitmaps. It lists the paths for bitmaps in this order: 

1. User-specific bitmaps. 

2. System bitmaps listed in the XmGetPixmap(3x) man page. 

3. Append: 

/usr/lib/Xll/bitmaps/y.N/y,B 
This ensures that you will get the non-localized bitmaps, where necessary. 

Other Language-Dependent Resource Files 

When LANG is set, X uses the following language-dependent default resource 
files: 

■ /usr/lib/Xll/y,L/sys.mwmrc. 

Native Language Fonts 

For information about using non- English fonts, refer to "Using Native 
Language Input/Output" in chapter 6. 
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Using the X Window System 



This chapter covers the basics of window operation. It shows you how to use 
X once it's been installed on your system. You'll learn how to perform the 
following tasks: 

■ Start the X Window System. 

■ Create, move, resize, and "shufRe" windows. 

■ Iconify a window and normalize an icon. 

■ Display menus and make selections. 

■ Stop programs and correctly exit your X environment. 
The following chapters contain related information: 

■ Chapter 3 explains configuration files used by the X Window System, 

■ Chapter 7 explains the window manager (mwm) in more detail. 
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starting the X Window System on HP-UX and OSF/1 
Systems 

Before you start the X Window System, you must be logged in to your 
computer system. Log in using your normal procedure. 

You should start the X Window System just once. With Xll running, you 
should not execute the xll start command again. Starting Xll and then 
starting it again while it is still running may cause undesirable results. 

Note, however, that you can restart the window manager and refresh the screen 
at any time. 

X will use the default .xll start, .Xdefaults, and .mwmrc files, unless told 
otherwise in the command line options. 

Note The X Window System can't run on a system that's 

I already running HP Windows/9000. If you are running HP 

Mi Windows/9000, you must exit from that window system before 

you start X. (HP Windows/9000 can be installed on your 
system; it just can't be running when you start X.) 



Starting X at Login 

Your system may be configured to start Xll as part of the login procedure. If 
so, skip the rest of this section and the next and start reading at "What to 
Expect When X Starts." 

Starting X from the Command Line 

If your system is not configured to start Xll at login, log into the system in 
the usual way and type the following command at the command prompt: 

Xl 1st art [ Return 1 
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Command-Line Options for xllstart 

In most cases, you will find it convenient to establish environment options in 
configuration files in your home directory. However, if you don't start XI 1 
automatically at login, you can include environment options on the command 
line after the xllstart command. The syntax for this is: 

xllstart [-clientoptions^ — [ {jpa^A}/5erver] [;rfisp/ai/] [-oph'ons] 

Client options pass from the xllstart command line to all clients in the 
.xllstart file that have a $(9 parameter. The options replace the parameter. 
This method is most often used to specify a display other than the usual one 
on which to display the client. You can, however, use the command-line option 
to specify a non-default parameter, such as a diflferent background color. 

The default .xllstart file starts the following clients: 

■ A terminal-emulation client (hpterm for HP-UX, or xterm for OSF/1 and 
Domain/OS). 

■ mwm. 

Server options are preceded with a double hyphen ( — ). If the option 
following the double hyphen begins with a slash (/) or a path and a slash, it 
starts a server other than the default server. If the option begins with a colon 
followed by a digit (:#), it specifies the display number (0 is the default display 
number). Additional options specified after the server or display refer to the 
specified server or display. See the XSERVER page in the reference section for 
more information on server options. 

The examples below illustrate starting the X Window System in different ways. 

xllstart The usual way to start X. 

xllstart -bg Blue Gives clients followed by $Q a blue background. 

xllstart — /X2 Starts server X 2 rather than the default server. 
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starting X on a HP-UX Multi-Display System 

A multi-seat system (a system with more than one display, keyboard, and 
mouse) requires modification of two Xll configuration files, to allow for more 
than one display seat. These files, X+screens and X*dGvicGS (where * is the 
number of the display), are located in your system directory. Each seat must 
have its own X*screens and X*devices files. If you have a multi-seat system 
but have not configured it, see your system installation or configuration manual 
for more information. Also see "Defining Your Display" in chapter 7. 

Seat uses the XOscreens and XOdevices files to configure its output and 
input devices. These files are supplied with the system, but you must still 
match them to your hardware configuration. To start Xll on seat (display 0) 
of a multi-seat system, log in as usual and type: 

XllStart (Return) 

To start Xll on seat 1 (display 1) of a multi-seat system, log in as usual and 
type: 

Xllstart :1 (Return) 

Here the — signifies starting the default server while the :1 specifies 
sending the output to seat 1. Seat 1 uses the Xlscreens and Xldevices files 
to configure its output and input devices. If your system has a multi-seat 
configuration, you must create these configuration files using the XOscreens 
and XOdevices files as models. 
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starting the X Window System on Domain/OS Systems 

You can run either the share mode server (Xapollo) or the borrow mode server 
(Xdomain) on Domain/OS systems. 

Xapollo is described in Using the X Window System on Apollo Workstations 
(015213-A02). 

This section describes the Xdomain server. 

Note Run only one X server at a time. If Xapollo or Xdomain 

I are already running when you try to start a new server, they 

^u conflict over resources, with unpredictable results. 

You can start the Xdomain server in any of five ways: 

■ From the command line, type: 

/etc/Xdomain (Return] 

Refer to the Xdomain man page for all possible options. This starts only the 
Xdomain server, not any clients. 

■ To use the xllstart script, type: 

Xl 1st art (Return) 

This script starts the Xdomain server and any clients it finds listed in the 
.xllstart file. 

The system-wide file, sys. xllstart in your system directory, starts the 
xterm and mwm clients. If you want other clients to run as part of starting 
Xdomain, copy the system- wide file into your home directory as .xllstart 
and make the appropriate changes there. The system-wide file is used only if 
there is no file in your home directory. 

Entries in the .xllstart file use this syntax: 

client {.-options] [ft] 

The client name and options are the same ones you would use to start the 
client from the command line. The "&" tells Xdomain to run the client as a 
background process, as shown in this example. 
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xclock -digital & 

■ To use the xinit client, type: 

xinit — /etc/Xdomain :0 ( Return ] 

This client starts the Xdomain server. Refer to the xinit man page for more 
options. List any clients you want to start in the "/xinitrc file. Entries in 
this file are similar to .xllstart, that is: 

client i' options] [&] 

■ To use the xdm client, type: 

xdm -server ":0 local /etc/Xdomain :0 be" (Return) 

The xdm client manages a collection of X displays. Refer to the xdm man 
page for all the possible options. 

■ To start the Xdomain server from xdm when your system boots: 

1. Modify the xdm/Xservers file in your system directory to include the line 

:0 local /etc/Xdomain be 
Remove or delete the line for Xapollo. 

2. Modify the xdm/Xsession file in your system directory to remove any 
Xapollo server entries. 

3. Run xdm from a pad. If it does not start correctly, redo steps 2 and 3. If 
it does start correctly, continue. 

4. Touch the /etc/daemons/xdm file. 

5. Reboot your system. 

Switching between Xdomain and the Display Manager 

You can switch between Xdomain and the Display Manager in either of two 
ways: 

■ Press (fq) when the (Left Shift) and (Ctrl) keys are down to switch from Xdomain 
to the Display Manager. The sequence of keys that switches from Xdomain 
to the Display Manager can be customized in the X*pointerkeys file. Refer 
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to chapter 9 or the XOpointerkeys file in your system directory for more 
information. 

■ Use the dmtox client to switch from the Display Manager to Xdomain. Start 
the dmtox client when the Display Manager is running. It displays an icon 
marked "X". Move the cursor over the icon and press (shift Pop) . 

If you start xdm as part of your boot-up procedure, you cannot switch to 
the Display Manager from the Xdomain server. If you first start the Display 
Manager, then run xdm, you can switch between the two. 

You may assign the iconize/de-iconize function to a mouse button; for example, 

kd m2 icon ke 

assigns the function to the middle mouse button. 

Xdomain responds to UNIX signals for switching. The usrl signal tells 
Xdomain to return the display and allow the Display Manager to run. The usr2 
signal tells Xdomain to reborrow the display and become the active window 
system. 

If Xdomain is running and the Display Manager has control of the display, 
the server restarts as expected, but takes back control of the display from the 
Display Manager after the last X client disconnects. 

Domain/OS Clients 

If you have trouble running Domain/OS clients, the problem might be that 
they were compiled under a different version of X. Edit your etc/sys . conf file 
to include the line: 

lib xllxlib 
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What to Expect When X Starts 

Whether you start the X Window System from the command line or 
automatically from a login file, xlistaoct always executes the same sequence of 
steps. 

1. If necessary, it adds the your system directory to your PATH variable. 

2. It looks in your home directory for a .xllstart command file to read. If it 
doesn't find one, it reads sys. xllstart in your system directory instead. 

3. It starts xinit, which starts the server and any clients specified in the 
.xllstart command file. 

4. It looks in your home directory for a .Xdef aults configuration file to read. 
If it doesn't find one, it reads sys. Xdef aults in your system directory 
instead. 

5. It reads the configuration file named by the $ENVIRONMENT variable, 
.Xdef aults -^os^name if the variable doesn't exist. 

You won't notice any eflfect from issuing the command until the X display 
server starts. 

The Server Creates the Root Window 

When xllstart starts the server (the program that controls the operation of 
your keyboard, mouse, and display), your screen will turn gray. This means 
that the screen has now become the root window, the backdrop or "desktop" 
on which the windows and icons of your environment appear. Although you 
can completely cover the root window with clients, you can never cover a 
client with the root window. The root window is always the backdrop of your 
window environment; nothing gets behind it. 

In the center of the root window is an hourglass. This is the pointer and marks 
the current screen location of the mouse. 
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A Terminal Window Appears on the Root Window 

A short time later the pointer changes to an x , and a terminal window appears 
at the top of your display (if you're using the default .xl 1st art file). This 
window is under the control of a window manager. If you use the OSF/Motif 
Window Manager (mwm), your window has a three-dimensional frame. This 
frame contains window manager controls. 
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Figure 4-1. The Default X Environment: 'mwm' and One Window 

The window contains a command-line prompt and behaves exactly like 
the screen of a terminal. You can think of this window as "a terminal in a 
window." There are two terminal emulation clients: hpterm and xterm. The 
examples in this book use hpterm. Refer to the man page for your terminal 
emulator for specific details about it. 

Move the mouse. The pointer moves on the screen. When the pointer is in the 
root window, it has an x shape. However, when you move the pointer to a 
terminal window, the pointer changes to an arrowhead (when on the window 
frame) or an I (when in the interior of the window). 
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With the OSF/Motif Window Manager, when you press and release button 
1 while the pointer is in a terminal window, the window becomes the active 
window. When a window is active, its frame changes color. You'll discover that 
you can't type in a terminal window unless the window is active. 

The active window is the terminal window where what you type on the 
keyboard appears. Your input always goes to the active window. 

If there is no active window, what you type is lost. 

The program running in the active window decides what to do with your typed 
input. Frequently the program will use a text cursor to show where your typed 
input will be displayed. 

What to Do If X11 Doesn't Start 



Table 4-1. Possible X Window System Start Problems 



If this happens . . . 


You should do this . . . 


The message commeind not found 
appears. 


Check your spelling and reenter the start 
command. 


The root window displays for a moment, 
but then goes blank. 




Press the (Return) key to bring back your 
original command-line prompt and see 
below. 


The root window displays, but no pointer 
appears. 




Press (CTRL) (Left Shift) (Reset) all at the 
same time. ((Exit J (Control] (Left Shift] for 
Domain/OS.) This brings your original 
command-line prompt back. See below. 


The root window and pointer display, but 
no terminal window appears. 


Press and hold button 3. If a menu 
appears, open a window. Otherwise, press 


( CTRL ) ( Shift ) ( Reset ) (( Exit ] ( Control ) 


(Left Shift) for Domain/OS.) 'I'ry restarting 


X, then see below if there's still a 
problem. 


The terminal window displays, but what 
you type doesn't appear after the 
window's command prompt. 


Move the pointer into the window and 
click (press and release) button 1, then 
type. 
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If you encounter problems starting XI 1 for the first time, check the following 
areas: 

■ Check the Xll start log in your home directory for clues by typing 



more .Xllstartlog ( Return } 

Check that the correct directory is in your PATH statement. If you do not 
have an entry for the system directory, x list art will add that entry to the 
path. You can be sure that the entry is always there by adding it to the path 
yourself. To check the PATH variable, type 

env (Return) 

Check that the DISPLAY environment variable is set correctly. If you do not 
already have an entry for either local: 0.0 or hostiO.O (where host is the 
hostname of your system), Xll will add it for you when Xll starts. You can 
add the entry yourself. To check the DISPLAY environment variable, type: 



env (Return) 

■ Check that you have the correct permissions for the .xllstart file in your 
home directory. Type: 

11 .xllstart (Return) 

The resulting permission should be at least: 
-rwx 

■ Check the .xllstart file in your home directory for errors. Compare it with 
the sys. xllstart file in your system directory. 

If none of the above seems to help, or you're not sure how to proceed, see your 
system administrator. 
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Working With Windows 

This section explains features of the OSF/Motif Window Manager (mwm). 

In the typical X environment, yon have two tools to control window operations: 

■ The mouse. 

■ The window manager. 

For most window operations, you'll use a combination of the window manager 
and mouse. (If you lack the space on your desktop, or feel more comfortable 
with a keyboard, you can configure your keyboard to take the place of the 
mouse.) 

Using the Mouse 

The X Window System works with either a two-button mouse or a 
three-button mouse. 

Table 4-2. Which Mouse Button Is Which 



To press 
this . . . 


On a 2-button mouse press . . . 


On a 3-button mouse press . . . 


Button 1 


the left button 


the left button 


Button 2 


both buttons 


the middle button 


Button 3 


the right button 


the right button 



Besides using the mouse to point with, you use the mouse buttons to select an 
operation to be performed on the object pointed to. Buttons have the following 
actions associated with them: 

Press To hold down a button. 

Click To press and release a button without moving the pointer. 

Double-click To click a button twice in rapid succession. 

Drag To press and hold down a button while moving the pointer. 



4-12 Using the X Window System 



The Anatomy of an mwm Window Frame 

mwm surrounds each window on the root window with a functional frame. 
Positioning the pointer on a part of the frame and performing a mouse button 
action will execute the function of that part of the frame. 



Prompt 



Pointer 



Resize 
Border 



d 



I — Window Menu 
r- Title Bar 



TenRlnal Window 



Cursor 



Figure 4-2. Window Frame Parts 



I — Minimize 
I — Maximize 

-Ul-r 



The parts of the mwm window manager, their functions, and the required mouse 
operations are listed in the following table. 



Using the X Window System 4-13 



Table 4-3. Window Frame Parts and What They Do 



Frame Part 


Function 


Mouse Action 


Title area 


Move a window. 


Press and drag button 1. 


Window menu 
button 


Display a window menu. 


Press button 1. 


Window menu 
button 


Select a window menu item. 


Press and drag button 1. 


Window menu 
button 


Close a window. 


Double click button 1. 


Minimize 
button 


Iconify a window. 


Press button 1. 


Maximize 
button 


Expand window to maximum 
size. 


Press button 1. 


Frame border 


Stretch or shrink a window 
horizontally, vertically, or 
diagonally (in two directions). 


Press and drag button 1 . 


Frame and 
window 


Keyboard focus selection. 


Press button 1. 


Frame and 
window 


(On focus selection) Top window. 


Press button 1. 



Activating a Window 

You make a window active by moving the pointer to any part of the window 
and clicking button 1 of the mouse. When a window is active, you can interact 
with it. 
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Changing Window Size and Location 

You can change the size of a window, change its location on the screen, and 
change its location on the stack 

Moving a Window around the Screen 

You can move any window (except the root window) by doing the following: 

1. Position the mouse pointer in the title bar. 

2. Grab the title bar by pressing and holding down button 1. 

3. Drag the pointer. An outline of the window shows you the window's new 
location. 

4. Position the outline and release button 1 to relocate the window. 
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Figure 4-3. An Outline Sliows the Window's Location 

You will notice that, along with the window outline, a small location box 
displays at the center of the screen. The numbers in this box are the column 
and row position of the upper left corner of the actual window (the area inside 
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the window frame). The measurement is in pixels. Pixels (short for picture 
elements) are tiny dots, arranged in rows and columns on the screen, that make 
up the displayed images. 

As mentioned in the previous section, you can also move a window by choosing 
the "Move" selection from the window menu. 

Changing the Size of a Window 

To change the size of a window, grab the window's frame with the pointer, 
drag the frame to the desired size, and then release the frame. 

Where you grab the frame determines how the window gets resized. If you grab 
the side of the frame, the window stretches or shrinks horizontally. If you grab 
the top or bottom of the frame, the window stretches or shrinks vertically. If 
you grab the frame by one of the corner pieces, you can expand or contract the 
size of the window in two directions at once. 

Tabie 4-4. Where to Grab a Window Frame 



If you want to stretch 
or shrink the window . . . 


Position the pointer on the . . . 


vertically from the . . . 


top 


top of the frame, above the title bar 


bottom 


bottom of the frame 


horizontally from the . . . 


right 


right side of the frame 


left 


left side of the frame 


diagonally from the . . . 


bottom left corner 


frame's lower left corner 


top left 


frame's upper left corner 


top right 


frame's upper right corner 


bottom right 


frame's lower right corner 
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The pointer changes shape when you're positioned correctly for the grab. 
Follow these steps to grab and resize the window: 

1. Position the mouse pointer on a part of the window frame. 

2. Press and hold button 1. 

3. Drag the mouse pointer. An elastic outline represents the new window size. 

4. Release button 1 when the elastic outline is the correct size. 




^ 



Figure 4-4. An Elastic Outline Shows the Window Size 

Although you change a window's size and shape during a resize operation, you 
do not change its position. The section of the frame opposite where you grab 
always remains in the same location. 

As mentioned earlier, you can also resize a window by choosing the "Size" 
selection from the window menu. If you choose the "Size" selection, you must 
cross the window frame's border with the pointer before the elastic outline 
appears. 
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Raising a Window to the Top of the Window Stacic 

To raise a window to the top of the stack (front of the screen), position the 
pointer on any visible piece of the obscured window and click button 1. This 
also makes the window the active window. 

An alternative in some situations is to lower the window on top of the stack by 
choosing the "Lower" selection from that window menu. 

Using Menus 

Menus provide a quick way of performing some action. You make a selection 
from a list and the action is performed for you. 

There are three types of menus you can use: 

■ window 

■ icon 

■ root 

Selecting from the Window fAenu 
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Figure 4-5. Every Window Klas a Window l\/lenu 

Every window has a window menu. The window menu button of a window is 
in the upper left corner of the window frame next to the title bar. You can 
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display the window menu at any time by pressing button 1 with the mouse 
pointer on the window menu button. 

There are three ways to display and use window menus. 

■ A sticky menu stays displayed until you make a choice. To display the 
window menu as a sticky menu: 

1. Position the pointer on the window menu button. 

2. Click button 1. 

3. Move the pointer to the selection you want to choose. 

4. Click button 1 on that selection. The window menu will disappear and 
the desired action will take place. 

■ A pulldown menu is displayed as long as a button is pressed. To display a 
window's window menu and make a selection: 

1. Position the pointer on the window menu button. 

2. Press and hold down button 1. 

3. Drag the pointer down the menu to the selection you want to choose. 

4. When the selection highlights, release button 1. 

5. (Move and Size only.) Move the pointer to the desired location or until 
the desired position or size is achieved, then click button 1 to end the 
operation. 

If you change your mind and don't want to make a selection, move the 
pointer off the menu area before you release button 1. 

■ You can also display the window menu by pressing (Left Shift) [esc] . To make 
a choice using this method, use the Q and Q keys to highlight a selection, 
then press [ Return ) . If you don't want to make a selection, press [Left Shift) [esc) 
again. 
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Window Menu Selections 

The following table describes the window menu selections. 

Table 4-5. The Window fAenu Selections 



To do this , . . 


Select . . . 


Restore a window from an icon or after maximizing. 


Restore 


Change the location of a window. 


Move 


Change the width and height of a window. 


Size 


Shrink a window to its icon (graphic representation). 


Minimize 


Enlarge a window to cover the entire root window. 


Maximize 


Send a window to the back or bottom of the window stack, the 
position closest to the root window. 


Lower 


Immediately stop the window and make it disappear. 


Close 



You can also use mnemonics and accelerators to select items from the window 
menu. An accelerator is a key that selects a menu item without posting 
the menu. For example, the accelerator (Alt) (f9) minimizes a window. The 
accelerators are shown on the right side of the menu items. 

Mnemonics let you select a menu item once the menu has been posted. The 
mnemonic for a menu item is indicated by an underlined character in its label. 
To select a menu item using its mnemonic, press the unshifted key for the 
underlined charcter. 

The rest of this chapter explains how you can use the mouse and the window 
manager to control the windows in your environment. 

Displaying and Selecting from the Root Menu 

The root window has its own menu called (not surprisingly) the root menu. 
You can display the root menu any time the mouse pointer is on the root 
window. When the pointer is in the root window, remember, it has an X 
shape. 



4-20 Using the X Window System 



To display and select from the root menu: 

1. Position the pointer anywhere in the root window. 

2. Press and hold button 3 to display the menu. 

3. Drag the pointer down the menu until you have highlighted the desired 
selection. 

4. Release button 3. 

To make no selection, move the pointer off the menu before you release button 
3. 
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Figure 4-6. The Root Menu Provides Screen-Wide Functions 

The default selections of the root menu provide you with screen- wide functions 
not appropriate for an individual window's window menu. 



Using the X Window System 4-21 



Table 4-6. What the Root Menu Default Selections Do 



To do this . . . 


Choose this selection . . . 


Make a new 80x24 hpterm terminal window near center 
screen. 


New Window 


Display an analog clock in the upper right corner of the 
root window. 


Start Clock 


Display a histogram measuring system load (displays 
next to the clock). 


Start Load 


Bring the most concealed window to the front of the 
window stack. 


Shuffle Up 


Lower the least concealed window to the bottom of the 
window stack. 


Shuffle Down 


Blank out then redisplay the screen (useful if video 
images become corrupt). 


Refresh 


Restart window manager to see recent configuration 
changes. 


Restart 



Icons 

You can save space and bring order to your workspace by reducing inactive 
windows to icons — small, easily-recognizable graphic images that represent 
full-sized windows. Later, as you need them, you can change the icons back 
into full-sized windows. 

Although you can't enter information into an icon, any program running in a 
window as it is iconified continues uninterrupted until it either completes or 
pauses to await input from you. 

Icons allow you to start an application in a window and then collapse the 
window into a tiny symbol over in the corner of your screen. There the 
program quietly does its work without cluttering up your workspace. 
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Figure 4-7. Pressing the Minimize Button Iconifies a Window 

Changing a window into an icon is known as iconifying or minimizing the 
window. To iconify a window: 

1. Move the pointer to the minimize button located in the upper right corner 
of the window frame between the title bar and the Maximize button. 

2. Press and release button 1. 

Immediately after you release button 1, the window is iconified. Successive 
icons are placed from left to right in a row along the bottom of the root 
window using a grid pattern. This placement is by default and can be changed 
if your needs require it. 
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Figure 4-8. Default Icon Placement Is along the Screen's Bottom 

You can also change a window into an icon by choosing the "Minimize" 
selection of the window menu as discussed earlier. 
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Turning an Icon Back into a Window 

When you have room on the root window, or simply want to check the progress 
of an application running in an iconified window, you can turn the icon back 
into a window. Changing an icon into a window is called normalizing or 
restoring. 

1. Move the pointer to the icon. 

2. Double-click button 1 (press and release it twice in rapid succession). 

After you double-click on the icon, the window will reappear located at its 
previous (pre-iconified) position. 

Displaying and Selecting from an Icon's Menu 

Although an icon doesn't have a frame like a window, it does have a window 
menu that gives you most standard control options. "Size" and "Minimize" 
appear on the menu but don't function with iconified windows. 

To display an icon's window menu and make a selection: 

1. Move the mouse pointer over the icon. 

2. Click button 1 to activate the icon and display the menu. 

3. Move the mouse pointer to the selection you want. 

4. Click button one to make the selection. 

To make no selection, move the pointer to the root window and click button 1. 
The icon will stay active until you make another window or icon active. 

Moving Icons around the Screen 

Although icons appear by default in a row along the bottom of the screen, you 
can move them anywhere on the root window. 
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To move an icon: 

1. Move the mouse pointer onto the icon. 

2. Press and hold button 1. 

3. Drag the pointer to a new location. An outline of the icon shows the current 
location. 

4. Release button 1. 



Exiting From the X Window System 

Exiting from the X Window System m^eans stopping the Xll display server. 
Leaving X places you back at the command prompt you had immediately after 
you logged into your system. 

Before stopping the X Window System, you must first stop any X clients 
you may have running. This ensures that you do not unknowingly leave any 
orphaned processes executing. It also ensures that all open files are properly 
closed to prevent loss of data. 

You need not stop any Domain/OS Display Manager clients that are running 
at the time. 

Caution Stop all X clients and any non-clients running in terminal 

• emulator windows before stopping the window system. If you 

don't do this, any open files may not be updated properly. This 
could result in the loss of valuable data. 



Stopping Application Programs 

You can stop a program and remove its window in three ways. 

Following the Program's Normal Exit Procedure 

The best way to exit a program is to use the program's usual "exit" procedure. 
This should always be your preferred method for stopping the program. Many 
programs have commands or keystrokes that stop them. 
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If the program is a client and created its own window, the window is removed 
when the client stops. If the program is a non-client in a terminal window, the 
window remains, and you can stop it when you stop the display server. 

Closing the Window 

You can also stop most applications by closing the window in which the 
application is running. To close a window: 

1. Position the pointer on the window menu button. 

2. Press and hold button 1. 

3. Drag the pointer to Close. 

4. Release button 1. 

Stopping the Window System 

HP-UX and OSF/1 Systems 

After stopping all application programs, stop the window system by holding 
down the (ctrl) and [Left Shift) keys, and then pressing the [Reset) key. This 
stops the display server, and with it the window system. 

The sequence of keys that stops the display server can be customized in the 
X*pointerkGys file. Refer to chapter 9 or the XOpointerkeys file in your 
system directory. 

Domain/OS Systems 

After stopping all client programs, stop the Xdomain server by pressing the 



[Exit) , [Control) , and [left Shift) keys simultaneously. 

Press the fpol , [Control) , and [Left Shift) keys simultaneously to swap control from 
Xdomain to the Display Manager. 

You can change these key sequences by using the XOpointerkeys file. Refer to 
chapter 9 or the XOpointerkeys file in your system directory for information 
and examples. 
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Application Resources 



Resources are data used by applications to set their appearance and behavior. 
This chapter covers: 

■ The various ways to change resource settings. 

■ The scope of resources — how specifically or generally a resource is applied. 

■ The syntax for specifying color and geometry resources. 



How Applications Obtain Attributes 

An application can get attributes from several different places: 

■ Resources directly loaded into an application's resource database: 
n Command-line options. 

n .Xdefaults file. 

n Resources loaded into the RESOURCE_MANAGER property. 

n Application resource files (for example, app-def aults files or .re files). 

■ Other sources: 

D Defaults built into the client. 

n Environment variables. 

n Inter- client communications. 

The following list shows how applications obtain resources. A resource at 
the top of the list overrides the same resource found further down the list. 
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For instance, a resource in .Xdef aults overrides the same resource in the 
app- defaults directory. 

■ Command-line options. These options are good for only that one instance of 
the application. A command-line option is the equivalent of a client, resource 
statement in a resource file. 

■ A host environment: 

D If an XENVIRONMENT variable exists, it may contain the name of a file that 
specifies application attributes. 

n A $HOME/.Xdefaults-/iosi file may contain resources to be used for a 
specific remote host. It is read only if no XENVIRONMENT variable exists. 

■ Personal resources: 

n Loaded into the RESOTJRCE_MANAGER property, 
n .Xdef aults (or sys. Xdef aults) file. 

■ User-specific files for particular classes of applications: 

D If an XUSERFILESEARCHPATH variable exists, it may specify a directory of 
files containing application class defaults for the specific user. 

n If XUSERFILESEARCHPATH variable does not exist, and if an XAPPLRESDIR 
variable exists, it may specify a directory of files containing user-specific 
application class defaults. 

n $EOKE/ app- class files may contain application resources. These files are 
read only if XUSERFILESEARCHPATH and XAPPLRESDIR do not exist. 

For information about these variables, refer to Programming with the Xt 
Intrinsics. 

u Application-specific configuration files in the app-def aults subdirectory 
of the system directory. Each file specifies attributes for a particular class 
of application. An app-def aults file is the equivalent of a Class* resource 
statement in a resource file. (The environment variable XFILESEARCHPATH 
may define a language-dependent location of app-def aults.) 

■ Internal defaults built into the application. 
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Ways to Change Resources 

There are several ways to change a resource. The way you choose depends on: 

■ The nature of the resource. 

■ When you want the change to take effect — immediately or at the beginning 
of the next session. 

Resources can be changed by: 

■ Loading the new resources into the server's RESOURCE-MANAGER 
property using the X client xrdb. 

■ Hand editing a resource file, such as .Xdefaults. 

■ Using command-line options. 



Setting Resources with .Xdefaults 

The .Xdefaults file contains default resources you want to apply each time a 
client is started. 

If you do nothing, the system uses the the sys .Xdefaults file in your system 
directory. If you want your own defaults to be used instead, copy this file 
into .Xdefaults in your home directory and make modifications there. For 
example: 

cp /usr/lib/Xll/sys. Xdefaults $HOME/. Xdefaults 

The syntax for describing resources is explained later in this chapter. 
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Changing the RESOURCE-MANAGER Property with 'xrdb' 

The RESOURCE-MANAGER property is a property on the root window that 
is treated the same way as a resource file by the resource manager. 

During a session, the RESOURCE_MANAGER property may be modified by 
the the xrdb client. 

You can use xrdb to load resources into the server's RESOURCE-MANAGER 
property. 

The syntax for xrdb is: 
-help 



xrdb 



ename 



-symbols 
-query 

' -load path/filename 
-merge path/filename 
-remove 

^ -edit path/filename 
-backup string 
-Iiname[= value] 
-Vname 

- Ipath/ directory 
-display host: display 



[filename] 



-help 
■display 

-query 

-load 



Displays a list of options for xrdb. 

Specifies the host and display of the server to be loaded 
with the configuration information. 

Displays the current contents of the server's 
RESOURCE-MANAGER property. 

Specifies that xrdb should load the file named on the 
command line into the RESOURCE-MANAGER 
property, overwriting the current resources listed there. 
This is the default action. 
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-merge 



-remove 
-edit 

-backup 
-cpp 



-nocpp 



-symbols 



-dname 



-Vname 



- 1 path/directory 



Specifies that xrdb should load the file named on the 
command line into the RESOURCE_MANAGER 
property, merging the new resources with the current 
resources instead of overwriting them. 

Removes the current configuration file from the 
RESOURCE_MANAGER property. 

Places the contents of the RESOURCE_MANAGER 
property into the named file, overwriting resources 
specified there. 

Specifies a suffix to be appended to the filename used in 
the -edit option to create a backup file. 

Specifies the path and filename of the C preprocessor to 
use when loading a configuration file containing #if def 
or # include statements, xrdb works with CPP and 
other preprocessors as long as they accept the -D, -U, 
and -I options. 

Specifies that xrdb should not use a preprocessor before 
loading the configuration file (the file contains no 
statements that need preprocessing). 

Displays the symbols currently defined for the 
preprocessor. 

Defines a symbol for use with conditional 
statements in the configuration file used by the 
RESOURCE_MANAGER property. 

Removes a defined symbol from the 
RESOURCE_MANAGER property. 

Specifies the search path and directory of # include 
files used in the RESOURCE_MANAGER. 



To add resources interactively: 
1. Execute: 

xrdb -merge -nocpp 
in a local terminal emulation window. 
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2. Type in the resource specifications. Each resource must be on a separate 
line. 

3. When you've typed all the resources, press (ctrl) (7) to merge the resources 
and restore the shell prompt. 

To add resources by typing the resources into a file that is then merged into 
the database: 

1. Create a file containing the resources you want to add. 

2. Execute: 

xrdb -merge -nocpp filename 



Syntax of Resource Specifications 

Resource files are text files. They must obey the following syntax rules: 

■ Each resource specification must be on a separate line. If the last character 
on a line is a backslash (\), the new-line following the backslash is ignored 
and the resource specification is assumed to continue on the next line. 

■ To add comments to resource files: 

o Use the exclamation ( ! ) character. Anything to the right of the ! is 
interpreted as a comment. This is the preferred way of commenting all or 
portions of lines. 

n You can place a pound (#) character in column 1. This makes the entire 
line a comment. Keep in mind that you must use the xrdb option -nocpp 
when loading a commented resource to avoid it being interpreted as a 
preprocessor directive. 

■ The resource name is separated from the value by a colon ( : ) and optional 
spaces or tabs. 
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The general syntax for specifying a resource for a client is: 

K client-name 1 1 , 

,. , , > * resource: value 
client-class J J 

For example: 

hptGrm*cursorColor: skyblue 

sets the color of the hpterm cursor to skyblue. 

Certain clients allow you to set resources for particular parts of the client. For 
example, 

hptenn*scrollBar*background : mediumblue 

sets the scrollbar on hpterm windows to mediumblue. 



Scope of Resource 

You can specify how generally or specifically a resource is applied. For 
example, you can specify that all clients have a background color of black (very 
general). At the other extreme, you can say that you want the softkeys of one 
particular hpterm window to be red. 

Scope of customization is determined by: 

■ Using names or classes of clients. 

■ Using names or classes of resources. 

■ Specifying particular areas of clients (for example, softkeys and scrollbars). 

■ Using wildcards in the resource string. 

Names and Classes of Clients 

Every client has both a name and a class. The name defines the specific client, 
while the class categorizes the client. Thus, the class is more general than the 
name. 

Frequently, the two identifiers are very similar, and often differ only in 
capitalization. For example, the client named xclock belongs to class Xclock. 
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Resources specified by client name take precedence over resources specified by 
client class. 

Naming a Client 

You can assign a name to a particular instance of a client. This allows you to 
allocate resources to that client by class, by client, and by name. 

For example, the following command line starts an instance of hpterm named 
localTerminal. 

hpterm -name localTerminal 

If the following resource exists in the resource database: 

HPterm.name: localTerminal 

localTerminal*background white 

then the localTerminal window will be white, overriding the colors used by 
the current palette. 

Names and Classes of Resources 

Like clients, resources have both a name and a class. 

An individual resource begins with a lowercase letter. For example, 
foreground refers to the foreground resource. A class resource, however, 
begins with an upper-case letter. For example, Foreground refers to the entire 
class of foreground resources. 

Thus, if no other specifications overruled, the line *f oregroimd: blue 
in your resource file would make all foregrounds blue. However, the line 
♦Foregroimd : blue would make all resources that belonged to the Foreground 
class blue. This would include such resources as foreground, cursorColor, 
pointerColor, bottomShadowColor for softkeys, frames, icons, and mattes. 
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Name/Class Precedence 

Specific resource specifications always have precedence over general 
specifications. For example, suppose a resource file contains: 

*Foregro\md : red 

HPterm*Foreground: DarkSlateGray 

HPterm*foreground: coral 

HPterm*cursorColor: green 

The first line makes all resources of the class Foreground red. The second 
line overrules the first line, but only in the case of clients of class HPterm 
(of which there is only one— the hpterm client itself). Line two makes the 
Foreground class resources of all hpterm clients DarkSlateGray. Lines three and 
four give hpterm clients coral foregrounds and green cursors, while the other 
resources of class Foreground (pointerColor, cursorColor, softkey foreground 
and bottomShadowColor, and scrollbar foreground and bottomShadowColor) 
remain DarkSlateGray for hpterm clients. 

Similarly, if a resource file contains: 

hpterm. name: local 

HPterm*softkey*background: wheat 

HPt erm*b ackgr ound : p ink 

local*background: white 

then all softkey backgrounds will be wheat. For the rest of the hpterm window, 
the backgrounds will vary. Windows named local will be white, other windows 
will be pink. 

Wildcards and Exact Paths 

The * character in a resource string is a wildcard that provides resource 
generality. For example, the following list of resources shows increasing 
specificity. 

*f oregroimd : white 

hpterm*foreground: yellow 

hpterm*softkey*foreground: red 
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The resource *f oreground refers to all foregrounds. The more specific 
resources override it. All the hpterm foregrounds will be yellow except for the 
foreground of the soft keys. 



Color Resources 

Resources take color names or rgb numbers as their values: 

■ The rgb.txt file in your system directory lists all the named colors. 

■ The rgb numbers have the syntax: 

MRedGreenBlue 

where Red, Green, and Blue are hexadecimal numbers containing 1, 2, 3, or 
4 digits that indicate the amount of that primary color used. There must 
be the same number of digits for each of the primary colors. Thus, valid 
color values consist of 3, 6, 9, or 12 hexadecimal digits. For example, black 
can be specified by any of these rgb values: #f f f , #f f f f f f , #f f f f f f ff f , or 
#ffffffffffff. 

For example, the following line specifies the background color of hpterm icons: 

Mwm*hpterm*iconImageBackgroimd : DarkSlateGrey 

Refer to the man page for a specific client to see which if there are special 
elements for that client that can be colored. For example, xclock allows you to 
color the hands and tic marks in addition to the background, foreground, and 
window frame colors: 

XClock*hands : Skyblue 

Or xterm allows you to control colors within a scrollbar: 

XtGnn*scrollBar*f oreground: Plum 
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Geometry Resources 

The geometry of a window is its size and location. The syntax for geometry 



resources is: 

' Widthx Height 
< :tcolumn±row 

Width X Heights column^ row ^ 

Use a lower-case x for the times sign 

Width 



Height 



column 



row 



The width in characters (for terminal windows) or pixels 
(for other clients). For widths in characters, the window size 
depends on the font size. 

The height of the window in lines (for terminal windows) or 
pixels (for other clients). The height of a terminal window 
depends on the font. 

The column location of the window in pixels. 

Plus (+) The location of the left side of the window 

values relative to the left side of the workspace. 

Minus (— ) The location of the right side of the window 

values relative to the right side of the workspace. 

The row location of the window given in pixels: 

Plus (+) The location of the top of the window relative 

values to the top of the workspace. 

Minus (— ) The location of the bottom of the window 

values relative to the bottom of the workspace. 
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Table 5-1. Example Locations for an 80x24 Terminal Window. 



To position a window here . . . 


Use this location . . . 


The upper left corner of the workspace. 


+1+1 


The lower left corner of the workspace. 


+1-1 


The upper right corner of the workspace. 


-1+1 


The lower right corner of the workspace. 


-1-1 



For example, the following line specifies that all hpterm windows be created 80 
characters wide and 24 characters high, and that they are initially placed in the 
upper right corner of the display. 

hpterm*geometry: 80x24-1+1 



Font Resources 

There are four general font resources that are commonly used. 
Table 5-2. General Font Resources 



Resource 


Description 


Font 


General user font 


FontList 


Displayed in system areas of clients 
created using the OSF/Motif toolkit. 


XmText*FontList 
XmTextField+FontList 


Displayed in text entry boxes of clients 
created using the OSF/Motif toolkit. 
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Use the following syntax to specify font resources: 

I client-class client-name^*fontr€source: fontname 
where: 

The class of the client for which you specify the font. 
The name of the client for which you specify the font. 
The name of the font resource. 



client-class 
client-name 
fontresource 
fontname 



The name, alias, or xlfd name of the font. Refer to chapter 8 
for information about how to specify font names. 



For example, 

hptGrm*Font : fontname 

Font resources and names are covered in more detail in chapter 6. 
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Using Fonts 

This chapter covers: 

■ Understanding and using the XLFD (X Logical Font Description) font name 
for bitmapped fonts and scalable typefaces. 

■ Displaying samples of bitmapped fonts and scalable typefaces. 

■ Setting font resources. 

■ Administering bitmapped fonts and scalable typefaces. 

■ Using fonts with Native Language Support. 
Chapters containing related information are: 

■ Chapter 5 covers where and when to set resources. 

■ Chapter 7 covers running clients from the command line. 

A font is a type style in which text characters are printed. The X Window 
System includes a variety of fonts. 

Bitmapped fonts are made from a matrix of dots. The font is completely 
contained in one file. Many files are needed to have a complete range of sizes, 
slants, and weights. 

Scalable typefaces are each defined by a file containing a mathematical outline 
used by the system to create a bitmapped font for a particular size, slant, or 
weight. 

The scalable typeface support provided is through the Intellifont technology 
from Agfa Compugraphic Division. The scalable outlines bundled with your 
operating system are "CO times", "Univers", and "Courier". 

The Intellifont Scalable Typeface Library from Agfa Compugraphic includes 
more than 180 different designs. Forty-six individual volumes of 4 faces are 
available, as well as six application-specific collections for all office publishing 
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needs. Please call Agfa Compugraphic directly at 1-800-873-FONT (3668) for 
a free brochure, or contact your local Hewlett-Packard Sales and/or Customer 
Service office for more information. 

Ninety-six of these typefaces are sold as part of the HP MasterType Library 
available from Hewlett-Packard and HP LaserJet printer dealers. 



Displaying a Font with 'xfd' 

You can display the complete character set of any valid font using the xf d 
client. The syntax for xf d is: 

-f n fontname 
-box 
xfd -center 

-start charnumber 
-be color 



-fn fontname The font to display. (Use the XLFD name or an alias name.) 

box A box is drawn around each character showing where a an 

ImageTextl6 request will cause background color to be 
displayed. 

-center Each glyph is centered in its box in the grid. 

-start Specifies that the character number charnumber be the first 

character displayed. 

-be The color to be used if ImageText boxes are drawn. 

xfd also accepts the usual toolkit options for colors, display, and other choices. 
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For example, the following command creates an xf d window displaying a font 
with the alias systemlS: 

xfd -fn systeml9 k 



xfd 



-Bitstream-Swiss 742-Meditam-R-Normal — 19-140-85-85-P-l 10-HP-Roman8 



I qui t [ jr'i & '/• j ji! ^x 1 1 



select 



metrics 



range: Qx002Q (0,32) thru QxQQfe (Q,25A) 



upper left: GxOOOO (0,0) 
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Figure 6-1. Displaying the system 19 Character Set with 'xfd'. 
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Customizing the Font Search Path with 'xset' 

The X server must know what directories contain fonts you want to use. The 
font path is a list of directories containing fonts accessible to the X Window 
System. If you add a font, you may need to add its directory to the font path 
and notify the X server of the new font. Similarly, if you no longer use a 
particular directory, you may remove it from the font path. 

To examine the font path, type: 

XSet q f Return 1 

To add or remove directories from the path: 

xset options 

where the options are: 

-fp path f, path... J Remove the directories from the head (-fp) or tail (fp-) of 
fp- path[,path...J the font path. 

+fp pathffpath...] Adds the directories to the head (+fp) or tail (fp+) of the 
fp+ path[,path...J font path. 

fp= path[,path...J Specifies the complete font path. 

fp default Resets the default font path 

f p rehash Causes the server to reread the font databases in the font 

path. This should be done after new fonts are added or 
deleted, after mkf ontdir is run, or after fonts . alias is 
changed in a directory already on the font path. 

More information about xset is in chapter 8. 
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Listing Available Fonts with 'xlsfonts' 

The xlsfonts client lists fonts available to you. It uses the fonts .dir and 
any fonts. alias files in the font search path to find the fonts. The XLFD 
name or the alias name is listed. (Refer to "The X Logical Font Description 
(XLFD)" for information about the XLFD name, and to "The fonts. alias File" 
for information about alias names. 

The xlsfonts client has the following syntax: 

xlsfonts [-opifons] 

where options are: 

-display hostidisplay The X server to send output to. The default is the 

requesting display. 



-1 

-11 

-111 

-m 

-C 

-1 

-w width 

-n columns 

-u 

-o 

-f n pattern 



Generate a medium listing. 

Generate a long listing. 

Generate a very long listing, showing individual 
character metrics. 

Long listings should show minimum and maximum 
bounds of each font. 

Multiple column listings. Same as -n 0. 

Single columm listings. Same as -n 1. 

Width in characters of each column. Default is 79. 

Number of columns for listings. 

Output is unsorted. 

Use OpenFont and QueryFont rather than ListFonts. 

xlsfonts will find all fonts that match this pattern. 
Wild cards may be used. If this option is not included 
xlsfonts lists all available fonts. 



A listing looks like this: 

-adobe-courier-bold-o-normal — 10-100-75-75-m-60-hp-roman8 
-adobe-courier-bold-o-normal — 12-120-75-75-m-70-hp-roman8 
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courblO 
courbl2 

The first two lines show the fonts' XLFD names, and the second two lines show 
the file name aliases for those fonts. 

If yon have many fonts on your system, xlsf onts can produce a long list. If 
you want to check for a specific font, use the pattern matching capability of 
xlsf onts. Use wild cards to replace the parts you are not trying to match. For 
instance, to see what scalable typefaces you have, type: 

XlsfontS -fn "*-0-0-0-0-*" (Return) 



The X Logical Font Description (XLFD) 

The standard X interface provides a detailed description of the font to the X 
server by means of the X logical font description (XLFD) name. The XLFD 
name is a string of characters that describes properties of the font you want. 

However, since the standard doesn't provide all the information necessary for 
scalable typefaces, HP has extended this standard to include scalable typefaces. 
This extension was designed in such a way that it supports either bitmapped 
fonts or scalable typefaces. 

The form of the XLFD is 15 fields separated by dashes. These fields are 
explained later in this section, 

" FontNameRegistry- Foundry Family Name- WeightName- Slant 

-SetwidthName-AddStyleName-PixelSize-PointSize-ResolutionX 

- Resolution Y- Spacing- Average Width- CharSetRegistry - CharSetCoding" 

For example, 

-adobe-courier-bold-o-normal — 10-100-75-75-m-60-hp-romaii8 

specifies a courier, bold, oblique bitmapped font created by Adobe. The font is 
10 pixels tall, 100 tenths of a point tall on a 75dpi X 75dpi display. Characters 
are monospaced, and are an average of 60 tenths of a point wide. Fonts codes 
are based on the HP RomanS encoding. 
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What is actually in the XLFD name differs depending on where in the 
font-request process the string is being used: 



reference XLFD 



request XLFD 



resolved XLFD 



This is the XLFD name shown by fonts . dir and the 
xlsfonts client. 

Scalable typefaces have the PixelSize, PointSize, 
Resolution X, Resolution Y, and Average Width fields 
set to zero. 

This is the XLFD name you use to request a font. It is 
also the XLFD name you use in a fonts, alias file. 

Any field in the list can be replaced by the "*" wild 
card. Any character in the list can be replaced by the 
"?" wild card. 

This is the XLFD name that the server returns when 
it has filled your font request. All the fields are filled 
in with the correct values for that font. However, they 
may not be the same values as in the request XLFD. 



XLFD Syntax 

This section explains the meaning of the fields in the XLFD name. Examples 
of the use of these fields are in a later section. 

The XLFD name is long, so you can assign a shorter nickname, or alias, for the 
font, which you then use in place of the long string. Aliases are discussed in 
"The fonts. alias File" later in this chapter. 

You may use either upper- case or lower-case letters when you specify a 
characteristic. Reference XLFD names are all lower-case. 

The text ^^ [extensions]" means that there are optional extensions to the 
standard XLFD properties that apply only to scalable typefaces. If you 
accidentally use them for a bitmap font, you will get an error. Notice that the 
underscore (_) character is used in some extensions to avoid confusion with the 
dash (-). 
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FontNameRegistry 

The authority that registered the font. Usually left blank. If there is a value in 
the field, it is of the form +version, where version is the version of some future 
XLFD specification. 

Foundry 

The name of the digital type foundry that digitized the font data. 

FamilyName 

The trademarked commercial name of the font. If the FamilyName contains 
spaces, do one of the following for a request XLFD name: 

■ Enclose the entire XLFD name in double quotes ("). For example, this 
fonts . alias file line. 

italic "-agfa-cg century schoolbook italic-normal-i-* 240 p-150-*-roiiiaii8" 

■ Use wild cards for part of the field. 

italic -agfa-*schoolbook*italic-iionaal-i-* 240 p-150-*-roBian8 

}Ne\glM.H3me [extensions] 

The relative weight of the font, such as bold. 

For scalable typefaces, the user may specify that the font be darker (bolder) or 
lighter than the normal for that font. The syntax for this optional extension is: 

±horiz-value 
[±veri_va/we] 

horiz-value, The increase (+) or decrease (_) in boldness. A value of 4000 
vert^value for a normal font simulated the bold version of that font. 

If only one delta and value are specified, they apply to both directions. 
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ABCDEFGHIJKLMNOPQRSTUVWXYZ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 

Figure 6-2. The Same Font at Increasing Weiglits 

S\3nX[extensions] 

A code indicating the direction of the slant for the font. 

r Roman (no slant) 

i Italic (slant left) 

o Oblique (slant left) 

ri Reverse italic (slant right) 

ro Reverse oblique (slant right) 

For scalable typefaces, the user can request additional slanting from the 
normal. The syntax for this optional extension is: 

dt value 

±valu€ The angle in 1/64 degree ranging from 0° to 44.5° (0-2880). 

(0.5° = 32, 1° = 64, etc) Values outside of that range will 
return an error. Use + for counterclockwise angles, _ for 
clockwise angles. 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
A BCDBFG/fl/A'L MATO PQ PSTC/V WXVZ 

Figure 6-3. The Same Font with Different Slants 
SetwidthName 

The width-per-unit of the font, such as compressed or expanded. 
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M6StY\Gf^Btne [extensions] 

A description of anything else needed to uniquely identify the font, such as serif 
or cursive. 

For scalable typefaces, this is the Compugraphic typeface number. 

For scalable typefaces, users can specify that the font be mirrored or rotated. 
The syntax for the optional extension is: 



+Mx 
+My 



[±an$f/e] 



+Mx, 

+My 

angle 



Mx mirrors the font horizontally, and My mirrors the font vertically. 

± the amount of rotation from normal in l/64th degree increments. 
Use + for counterclockwise angles; use _ for clockwise angles. If 
the angle is not included, a complete flip in the desired direction is 
assumed. 
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Figure 6-4. Font Mirrored Horizontally and Vertically 

Don't confuse "slant" with "rotation". A character that has been slanted has 
its base in the normal position and the top pushed to one side. A character 
that has been rotated has been moved around some central pivot point. 

PixelSize 

An integer describing the height of an EM square in pixels. 

For scalable typefaces, use either PixelSize or PointSize, but not both. 
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PomtSize [extensions] 

An integer giving the EM square size in decipoints. For example 140 is 
14-points. 

For scalable typefaces, you can expand the horizontal size (set size) to make a 
font wider or narrower than normal for that font. The syntax for this optional 
extension is: 

[+setsize] 

-f-setsize The horizontal size in decipoints. If this field is not specified, it 

is assumed to be the same as Point Size. 

For example, "140+240" requests a font 14-points high, but 240 points wide. 

If neither PixelSize or PointSize are specified, the assumption is 12-point. If 
both are specified and they conflict, an error is returned. Use either PixelSize 
or PointSize, but not both. 



ABCDEFGHIJKLMNOPQRSTU\'\VXYabcdel^]ii.^diuiioixp«tiivvixjr 

ABCDEFGHUKLMNOPQSSTUVWXTabcdefehlJklinnopqrBtuvw!^' 

ABCDEIt^HIJiaAlNOPQSSTUV^Xl'abcdeigU^diiiiiopqretiiv^ 

ABCDEFGHIJKLMNOPQRSTUVWXYabcdefghiJdmnopqrstiivwicy 

ABCDEFGHIJKLMNOPQRSTUVWXYabodefjghiJtlinnopqrstmTiray 

ABCDEFGHUKLMNOPQRSTUVW^XYabcdefghijklmnopqrstuvwxy 

ABCDEFGfflJKLNlNOPQRSTUVWXYabcdefgliijkliiinopqrstuvvwKy 

Figure 6-5. The Same Font in Different Sizes 
ResolutionX, ResolutionY 

The horizontal (X) and vertical (Y) resolution of the device that the font was 
designed for, measured in pixels-per-inch. If the resolution is not specified in a 
request XLFD name, the X server defaults to the resolution of the display for 
which the font is requested. The stmkf ont font compiler defaults to 100dpi. 
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Spacing 

A code indicating the spacing between units in the font. 

M Monospaced (fixed pitch) 

P Proportional spaced (variable pitch) 

C Character cell. The glyphs of the font can be thought of as "boxes" 

of the same width and height that are stacked side by side or top to 

bottom. 

AverageWidth 

An integer string giving the average, unweighted width of all the glyphs in the 
font, measured in 1/lOth device-dependent pixels. 

CharSetRegistry 

The registration authority that registered the specified CharSetEncoding. The 
XLFD conventions expect organizations that control characters to register with 
the X Consortium and be given a unique name to use in this field. 

ChBrSetEnco6mQ [extensions] 

The character set from which the characters in the font are drawn. 

For scalable typefaces, this field can be used to specify subsets of any of the 
character sets. The syntax for this optional extension is: 

-value, value... 

value A list of the decimal values of the characters to be included, 

separated by commas. 

If an application requests a character not in the subset, then: 

■ A space will be substituted for that character if space is in the subset. 

■ The first character of the subset will be substituted if space is not in the 
subset. 

In this example, the left side was printed using the full hp-roman8 character 
set. 

-agfa-univers medium normal-*-*-200 *-*-hp-roman8 
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The right side used a subset of the hp-roman8 character set. The subset 
consists of the characters *, H, 1, o. The "e" was accidentally left out of the 
subset, so when the screen tried to display "Hello", it had to substitute the "*" 
for the "e". 

-agfa-univers medium normal-* -*-200 *-*-hp-roman8=42,72,108,lll 



Hello H^llo 



Figure 6-6. 



Using the XLFD Font Name 



You use the XLFD name or alias whenever you need to specify a font. Some 
locations are: 

■ Application default or resource files, for example: 

hpterm*Font: fontname 

■ Command line to start clients or applications, for example: 

xclock -digital -fn fontname 
u The fonts. dir file. Refer to "The fonts.dir File". 

■ The fonts. alias file. Refer to "The fonts. alias File". 



The fonts.dir File 

The server associates the font file name and the XLFD font name by means 
of the fonts .dir file in each font directory. This file is created by the font 
installation process or by executing the mkf ontdir utility, mkf ontdir is run 
after you add or delete fonts from a directory so that fonts.dir will know 
about the change. You can view the font characteristics for all the fonts in the 
directory by typing: 

more path/ f out S.dlT [ Return ] 
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where path is the font subdirectory of your system directory. 

Scalable typefaces listed in fonts. dir will have some values set to zero. 

A fonts .dir file looks similar to this: 

7 

helvOOS . scf -adobe-helvet ica-medinai-o-iioxaal — 8-80-75-75-P-47-lip-roman8 

helvBOOS . scf -adobe-helvet ica-bold-o-nor«al — 8-80-75-75-P-48-lip-r<aMui8 

helTR08 . scf -adobe-helvet ica-medium-r-noiMal — 8-80-75-75-P-46-hp-roBan8 

ant.oliT . if o -agfa-antiqae olive bold-bold-r-norBal-91118-O-O-O-O-p-O-hp-tdOOOOOOOO 

ant_oliv . if o -agfa-antiqae olive coiiipact-noniial-r-coii5)act-91120-0-0-0-0-p-0-hp-td00000000 

ant.oliv . if o -agfa-antiqae olive italic-noniial-i-noniial-91846-O-O-O-O-p-O-hp-tdOOOOOOOO 

ant.oliv . if o -agf a-antique olive-noniial-r-normal-91119-O-O-O-O-p-O-hp-tdOOOOOOOO 

In this example: 

■ The first line lists how many bitmapped fonts and scalable typefaces are 
described by the file, in this case 7. 

■ The rest of the lines give the file name and XLFD name that describes the 
file. 

a The 3 lines starting with helv . . . are 3 different bitmapped fonts. They 
are different versions of the "Helvetica" style made by Adobe. They are all 
8-points in size, but differ in the slant and boldness. 

D The last 4 lines are 4 scalable typefaces. Several fields in the reference 
XLFD name are set to zero. In the request XLFD name you use to 
request one of these fonts, you supply values for either the PointSize or the 
PixelSize. 

The X server tries to match your request with the bitmapped fonts and 
scalable typefaces listed in the fonts. dir file as follows: The server looks in 
the directories in your font path in the order shown by xset q. 

■ Bitmap fonts. 

The server uses the first font that it finds that meets all the criteria you 
specified in the XLFD name. If you specified everything, it will try to find 
the exact match. If you used the wild cards (* or ?), it will use the first font 
that matches the parts you did specify. 

■ Scalable typefaces. 
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The PixelSize, PointSize, ResolutionX, and ResolutionY fields in the 
reference XLFD name are zero. Your request XLFD name must have either 
the PixelSize or PointSize (but not both). The server returns a font made 
from the outline with the specifications you requested. 

If none of the above have resulted in a font being returned, the X server 
returns an error message. 

For example, if you had the f onts .dir file shown above, then if you ask for 

xfd -fn *-*-helveticaTBediTim-*-*-*-*-*-*-*-*-*-hp-romaii8-* 

the first font (helvOOS.scf) will be used. The third font (helvROS.scf ) is also 
helvetica medium, but helvOOS.scf is used because it is the first in the list to 
match the fields you specified. 



The fonts.alias File 

A font can be referred to by an alias. The alias is shorter and easier to 
remember (and type) than the complete font description. Aliases are found in 
the fonts.alias. The fonts.alias file need not be in each directory, but the 
directory containing it must be in the font path. 

A simple fonts.alias file is created as part of installing the font. The 
fonts .alias file is in this format: 

"FILE.NAME.ALIASES" 
alias-name xlfd-name 

where: 

alias-name is the nickname for the font. 

xlfd-name is the XLFD name that specifies the font. If the family name 

contains spaces, enclose the whole XLFD name in quotation 

marks("). 

The fonts .alias file provides for two types of alias names: 
■ The font's file name. 
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If the string "FILE_NAMES_ALIASES" occurs in the fonts. alias file, then 
a font can be referred to by its file name alone, without the path name or 
extensions. The X server will look in all the directories in your font path. 

■ A name you select. 

You can specify what alias to use for referring to a font. 

Any fonts not in the fonts . alias file must be referred to by the XLFD name. 

Remember, whenever you edit a fonts. alias file, run xset fp rehash to let 
the X server know about the change. 

Using Alias Names 

For example, with this fonts. alias file and the fonts/hp_roman8/75dpi 
subdirectory of the system directory in the font search path: 

"FILE_IAHES_ALIASES" 

ellen *-adobe-coTirier-bold-r-iionBal-*-8-80-75-75-iB-50-hp-roman8 

then you can use any of the following commands to start a digital clock using 
this font: 

■ The "FILE_NAMES -ALIASES" entry lets you use just the file name, 
without the path or extension. 

xclock -digital -fn CourBOS 

■ The alias name you specified. 

xclock -digital -fn ellen 

■ You can always specify the XLFD name, whether or not you have a 
fonts. alias file. 

xclock -digital -fn *-adobe-courier-bold-r-noniial-*-8-80-75-75-Bi-50-hp-roiiiaii8 

■ You can specify enough of the XLFD fields to identify the font characteristics 
you want, and represent the rest with wildcards, with 14 dashes separating 
the fields. The X server selects the first font in its search path that matches 
the specification. 

xclock -digital -fn *-*-courier-bold-r-nonnal-*-8-*-*-*-*-*-lip-roman8 
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This is useful for vendor independence — you can have the same programs and 
default files on different vendors' computers, and customize by making the 
appropriate entry in the fonts. alias file. 



Errors 

If you get a default font or an error message (such as "can't make font ... ") 
when you request a font: 

■ Check the XLFD name for spelling. 

■ Check the XLFD name for inconsistencies. For instance, you cannot specify 
both the PixelSize and PointSize for scalable typefaces. If you think there 
might be a conflict, set one of the parameters to an asterisk (*) and try 
again. 

■ Run xlsf onts to see if the font you requested is available to you. 

■ Run xset q to see if the directory containing the font you requested is in 
your font search path. 

■ Run xset fp rehash to be sure the X server is using the latest aliases and 
font paths. 



Bitmapped Font Administration 

Bitmapped fonts are included with the X Window System. They are located 
in the fonts subdirectories of the system directory. You may use them as 
described in the following chapters without special installation or licensing 
steps. 
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Adding and Deleting Bitmapped Fonts 

To add a bitmapped font: 

1. Put the font into the .snf format using bdftosnf. 

2. Compress the .snf file using compress. For HP-UX, rename the .snf .Z 
compressed file into .scf . 

3. Copy the file into the desired directory. 

4. Run mkf ontdir to update the f onts .dir file for that directory. 

5. Run xset -f p rehash to notify the X server of the changes. 
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To delete a bitmapped font: 

1. Delete the font file. 

2. Run mkfontdir to update the fonts. dir file for that directory. 

3. Run xset -f p rehash to notify the X server of the changes. 

Creating a fonts.dir file with 'mkfontdir' 

The mkfontdir utility creates the fonts.dir file within a font directory. 
The syntax for mkfontdir is: 

mkfontdir directory, directory, . . . 

where: 

directory is a font directory. If no directory is given, the current 

directory is assumed. 

Compiling BDF Fonts to SNF Fonts with 'bdftosnf 

The X Window System fonts that the server uses to display text can be in 
either of two font formats: server compressed format ( .scf ) or server natural 
format (.snf). Both formats function the same. The compressed format takes 
up less storage space on disk but must be uncompressed by the server for use. 

A font's format is signified by the extension that appears after the font 
file name. A .scf signifies a compressed format; a .snf signifies a natural 
(uncompressed) format. 

You can compress an . snf font file using the HP-UX compress command. You 
can uncompress an .scf font file using the HP-UX uncompress command. 

The font compiler bdftosnf converts a font in bitmap distribution format 
(BDF 2.1) into server natural format. 
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The syntax for bdf tosnf is: 



bdftosnf 



'•pnumber 
-unumber 



-w 
-W 
-t 
-i 



filename >font.snf 



where: 
-P 

-u 
-1 

-L 
-m 

-M 

-w 
-W 
-t 
-i 



Specifies that font characters should be padded on the right 
with zeros to the boundary of word number where number is 1, 
2, 4, or 8. 

Force the scanline unit padding to 1, 2, 4, or 8. 

Specifies the output of bdftosnf to be least significant byte 
first. 

Specifies the output of bdftosnf to be least significant bit first. 

Specifies the output of bdftosnf to be most significant byte 
first. 

Specifies the output of bdftosnf to be most significant bit 
first. 

Print warning if the character bitmaps have bits set to one 
outside of their defined widths. 

Print warning for characters with an encoding of -1. The 
default is to ignore such characters. 

Expand glyphs in "terminal emulator" fonts to fill the 
bounding box. 

Don't correct ink metrics for "terminal emulator" fonts. 
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filename Specifies the name of the bitmap distribution format font to 

convert to server natural format. 

Note that bdf tosnf by default sends output to standard output (typically the 
screen). To capture the output as a .snf file, therefore, you must redirect the 
output as shown in the above syntax. Be sure to include the . snf filename 
extension. 

The following HP-UX example takes a bitmap distribution bitmap font file 
named tmrml2b.bdf, converts it to an .snf file, then compresses it into an 
.scf file: 

bdf tosnf tmniil2b.bdf > tmrml2b.snf 
compress < tmrml2b.snf > tmnnl2b.scf 

Note that the compress command does not automatically create a .scf file, so 
you have to move or copy the compressed tmrml2b . snf . Z file to tmrml2b.scf . 

If you are using OSF/1 or Domain/OS, you do not need to rename the .Z file. 



Scalable Typeface Administration 

A font administrator is anyone who has purchased a font and wants to use it 
on a system. Scalable typefaces, unlike the X bitmap fonts, are licensed. Read 
your license carefully. The font administrator is responsible for ensuring that 
the font is used in a legal manner. The permissions for files and directories that 
relate to scalable typefaces have been carefully chosen to allow you to fulfill 
your responsibilities. 

The font administrator has three main tasks: 

■ Install and delete scalable typefaces. 

■ License and unlicense devices to use typefaces. 

■ Add and delete character sets. 

Each system is shipped with a core set of scalable typefaces installed in the 
fonts/if O.St subdirectory of the system directory. You can list them by 
typing . . . 
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xlsfonts -fn "*-0-0-0-*" 

... as described earlier in this chapter. 

You can purchase additional typefaces for your system if you wish. HP sells the 
HP Master Type Library through computer dealers. Agfa sells the Intellifont 
Scalable Outlines Library direct from Agfa. Typefaces usually come on PC 
flexible discs, and are labeled for use with the HP LaserJet III printer. 

Overview 

There are four steps a font administrator must perform to make a scalable 
typeface ready for use. (These steps are covered in more detail in the following 
sections.) 

1. Load the typeface into a directory on the target system ("Installing and 
Licensing Scalable Typefaces"). 

2. Load the character set if it is not already on the system ("Adding and 
Removing Character Sets"). Character sets are used by several different 
typefaces. 

3. Run stmkdirs for that directory to notify the X server of the addition. 
("Creating *.dir Files with 'stmkdirs'") 

4. Add the license to that typeface for the system ("Adding and Removing 
Licenses with 'sthcense'"). 

An example of installation and removal of a typeface and its license is 
presented later in this chapter. 

Before using an installed scalable typeface, individual users should do one of 
the following: 

■ Use xset to add the directory to the font path if it isn't already there. 

■ Run xset f p rehash to inform the server about the font if the directory is 
already on the font path. 

These are covered in "Customizing the Font Search Path with 'xset'". 
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Installing and Licensing Scalable Typefaces 

To install a scalable typeface onto a system: 

1. Decide what directory will contain the new typefaces. 

■ If you use the fonts/if o.st/ subdirectories of the system directory, you 
will have all your fonts in one location, but you need superuser capability 
to write in those directories. 

■ If you create your own directory, you do not need superuser capability. If 
you create a new directory, be sure: 

D to give it the extension .st. 

n to make it readable for the group bin. 

n to have users add it to their font paths. 

2. Copy the files containing the typeface into an empty temporary directory on 
the target file system. 

If your typefaces come on several flexible discs, load the entire contents 
of each disc into its own temporary directory or do these steps for each 
individual disc. If you copy all the discs into one directory, some files will be 
overwritten. 

Copy the entire contents of the disc even if you want only one typeface from 
it. 

■ For HP-UX media, copy the files directly to the temporary directory. 

■ For MS-DOS media, the doscp utility can be used to copy the files from a 
flexible disc drive to the temporary directory 

■ If a PC is networked into your system, refer to the network documentation 
about how to copy the files from the PC to the HP-UX system. 

3. Run the stload utility on each temporary directory to convert the files into 
the proper format and place the typeface in the permanent directory you 
established in step 1. 

4. If you loaded more typefaces than you wanted, remove the file(s) and run 
stmkdirs for that directory. 

5. Delete the temporary directories used in step 2. 
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Once the file is loaded, typefaces can be made available to users through 
licensing. Refer to "Adding and Removing Licenses with 'stlicense'". 

To delete a typeface from a system: 

1. Remove all licenses for the product, using stlicense. For example 

stlicense -pr foo -fp /users/ellen/ifo.st "*" 

removes all licence all licenses to product "foo" in the specified directory, to 
product "foo" in the specified directory. 

2. Remove the typeface files (*.ifo) from the typefaces subdirectory. 

3. Run stmkdirs in the typefaces subdirectory to update the fonts . dir file. 

4. Remove the product file from the products subdirectory. 

Loading Scalable Typefaces with 'stioad' 

The syntax for the stload utility is: 

stload [oj?<ions] [directorySJilespec] 
where 



directory\filespec 
-o path 

-f p path 

-p product-number 



•list 
•link 



Required parameter specifying the name of the 
directory or filespec of the data to be loaded. 

The name of the directory to which the the typeface 
outlines should be written. If this is omitted, 
the default is to the /fonts/if 2. td/typef aces 
subdirectory of the system directory. 

The name of the base directory under which 
typefaces, metrics, and products directories should 
be used. 

Associates a product number with the newly-loaded 
tpeface. Although this could be anything, it should 
reflect the product number on the package and media. 
The stlicense utility requires this product number. 

Prints a list of the data located in directory. 

Make links to the original directory, rather than copies. 
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-sym 

-id[,-id . .. ] 

-tfm 

-dos 

-d mapdir 

-to format 

-f libname 



Make symbolic links to the original directory. 

Identifies one or more specific typefaces to be loaded. 

Updates .tfm files in the output directory. 

Specifies that the typeface file is in DOS format, 
stload converts DOS files into HP-UX files. 

Specifies the directory containing the symbol list map 
required by the -to option. 

Specifies the symbol list that should be used for 
assigning character ID codes when loading FAIS data. 

Specifies the name of the library into which FAIS data 
should be loaded. 



Specifies that the . dir files not be updated. 
Specifies verbose mode. 
Requests help. 



-u 

-V 

-h 

For example: 

stload -fp new. St -p C2054#ABA -tfm -dos -v tempdir 



Creating *.dir Files with 'stmlcdirs' 

stmkdirs creates the fonts .dir file from the directory of font files 

stmkdir s [ options ] directory [ , directory, . . . ] 
where the options are: 
-tfm 
±m 



±o 



±f 



build TFM files in the specified directory. 

Requests that fonts . dir be generated including (+) or 
excluding (-) bitmap fonts. 

fonts. dir is generated including (+) or excluding (-) .ifo 
libraries. 

fonts. dir is generated (+) including excluding (-) both .ifo 
libraries and bitmap libraries, or not generated (-). 
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±c Requests that charsets.dir be generated (+) or not generated 

(-)• 

-b Supresses creation of backup files. 

-h Prints help information on stout. 

directory is one or more directory names containing fonts. 

For each directory listed, stmkdirs reads all the font files in that directory, 
putting file names and XLFD name into the f onts .dir file. Without a 
fonts. dir file, the server cannot access font files in the directory. 

Run stmkdirs after any fonts or charsets are added or deleted. 

Adding and Removing Licenses with 'stiicense' 

When you purchase a scalable typeface product, you receive a license 
agreement, outlining by who and how the typefaces in the product may be 
used. For instance, the terms may be that only one printer and one display 
may use the typefaces. 

The stlicense utlity helps administer the licenses. Fonts will be available only 
to licensed devices. 

The syntax for the stlicense utility is: 

stlicense [-fip directory] < >[±device... ] 

where 

-f p The path of directories to search for the specified product 

or typeface. The default is /fonts/if est/ in your system 
directory. 

-f n The typeface being licensed. The typeface is specified as 

an XLFD name. You need not use the whole XLFD name, 
just enough to uniquely identify the typeface. A product is 
identified by its name or product number, product name. 

-pr The product being licensed. 
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±device The device is specified in the form: host: device. The given 

typeface is added to or removed from the list of typefaces 
licensed for this device. 

The host name STSYSTEM refers to all hosts served by this 
typeface directory. 

The device name DISPLAYS refers to all displays running on the 
host. 

The device name PRINTERS refers to all printers connected to 
the host. 

If the machine is not specified, the default is the machine 
on which stlicense is running, and the device defaults to 
DISPLAYS. 

nothing If no devices are given, a list of devices that have licenses for 

the typeface is printed on the standard output. The list is 
grouped by system and individual device licenses. 

The built-in typefaces are licensed at installation time to all displays 
and printers attached to the system (STSYSTEM: DISPLAYS and 
STSYSTEM: PRINTERS). For example, 

stlicense -pr C2054#ABA +lj3 

licenses the printer named lj3 to use the typeface product C2054#ABA. Since 
the machine is not specified, stlicense assumes the machine to be the one on 
which it is running. 

stlicense C2054#ABA -pr -laserjp +laserkb 

Adding and Removing Character Sets 

Each typeface ( . sym file) contains over 500 characters, so it can be used to 
create a large number of character sets. 



Using Fonts 6-27 



Character set definitions are stored in the f onts/stadmin/if o/charsets 
subdirectory of the system directory as ASCII files with the extension .sjrm. 
The charsets directory is shipped from the factory with two popular character 
sets definitions: 

■ HP Roman 8 

■ ISO 8859-1 (also known as ECMA Latin 1) 

These character sets are the only ones many applications need. 

The archive subdirectory contains definitions for a number of additional 
character sets. These include character sets popular for PCs. 

To enable one of the character sets in "archive": 

1. Copy the desired character set (.sym) file from the archive subdirectory 
into the charsets directory. For example, 

cp /usr/lib/Xll/fonts/stadmin/charsets/archive/pcS.sjrm .. 

2. Run stmkdirs in the charsets directory to update the charsets. dir file. 
For example, 

stmkdirs /usr/lib/Xl 1/fonts/st admin/ charsets 

3. Have your users update their font paths. 

xset fp rehash 

To install a character set from the Type Director/DOS product, first run 
stconv on the .sym file to put it into a format that can be used on your 
workstation. 

To delete a character set: 

1. Remove the character set (.sym) file from the charsets directory. (It is still 
in the archive subdirectory if you need it later.) 

2. Run stmkdirs with the +c option in the charsets directory to update the 
charsets . dir file. 

3. Have your users run xset f p rehash to notify the server of the change. 

Example: Installing and Licensing 

This example shows installing and licensing a product called "COOOO#AAA". 
Path names are shown in full for clarity, you may not need to specify them in 
that detail. 

6-28 Using Fonts 



"COOOO^j^AAA" is the product number on the box of the product. It comes 
on two flexible discs. 

A new scalable typeface directory is to be created. It is owned by the font 
administrator, /users/ellen. A flexible disc drive is attached to the system at 
device location /dev/rdsk/2sl. 

1. Copy each of the two discs into its own temporary directory. 

mkdir /tmp/discl 

insert flexible disc 1 into the drive. 

doscp /dev/rdsk/2sl/* /tmp/discl 

mkdir /tmp/disc2 

insert flexible disc 2 into the drive. 

doscp /dev/rdsk/2sl/* /tmp/disc2 

2. Create a new directory for the scalable typeface and make it readable by the 
bin group. All other groups should have no access to the . if o files. 

mkdir /users/ellen/new.st 

chad "•/, .bin+r" /users/ellen/new.st 

mkdir /users/ellen/new . st/typef aces 

chad "•/, .bin+r" /users/ellen/new. st/typef aces 

3. Load the typefaces into the new directory. Note that this example includes 
the creation of .tfm files. If you have applications that utilize AutoFont 
Support, you will need them. Otherwise, save installation time and disc 
space by not requesting them. 

stload -p COOOOtAAA -dos -v -fp /users/ellen/new.st -tfm /tmp/discl 
stload -p COOOOtAAA -dos -v -fp /nsers/ellen/nev.st -tfm /tmp/disc2 

4. Make the new files readable by the bin group. 

chad "•/,. bin+r" /users/ellen/new. st/typef aces/*" 

5. Clean up the temporary directories. 

rmdir /tmp/discl 
rmdir /tmp/disc2 

6. Have your users add the new directory to their font paths. 

xset fp+ /users/ellen/new.st 
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7. Before this product can be used, it must be licensed. For this example, the 
license in the product stipulates that the typefaces can be used for up to 
three printers and any number of displays connected to the system. 

stlicense -fp /nsers/ellen/new . st -pr COOOOtiAi +STSYSTEN: DISPLAYS \ 
+Hysystem:laserl 4aysystem:laseT2 +BiysyeteB:laser3 

Notice that although the printers are listed individually, the displays are 
grouped by the shortcut STSYSTEM: DISPLAYS, mysystem is one of the hosts 
covered by STSYSTEM. 

If you now wanted mysystem: las er4 to be licensed, you have to remove the 
license for one of the other printers, since you are only allowed up to three 
printers. 

stlicense -fp /users/ellen/new.st -pr COOOOtAAA -mysystem :laser3 \ 

+mysystem:laser4 

When the product is no longer needed, remove it from the system. 

1. Remove all licenses to the product. 

stlicense -fp /users/ellen/new.st -pr COOOO#AAA "-*" 

2. Remove the typeface files ( . ifo). The list of files to be removed is in 
/users/ellen/new . st/products/COOOO#AAA. 

rm /users/ellen/new. st/typef aces/ 12345678. ifo 
rm /users/ellen/new . st/typef aces/22345678 . ifo 

3. Update the f onts .dir in the typefaces subdirectory. 

stmkdirs /users/ellen/new .st/typef aces 

Disc Space Management 

Type Director tries to conserve disc space whenever possible. One copy of an 
outline is shared by all the devices using Type Director. The X server loads 
bitmapped fonts directly into memory, so there is no need to store them on 
disk. 

However, you might want to store frequently used fonts on disc, so that they 
are recreated each time they are called. You can also delete fonts that are 
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infrequently used, and let Type Director build them new each time. If there are 
outlines that you don't use, you can delete them also 

Remember to run stmkdirs for each directory in which you have added or 
deleted outlines or bitmapped fonts. 

Scalable Typefaces File Structure 

This section describes the default scalable font directories (font catalogs). 
There can be other font catalogs, but each must have the .st extension and 
structure described here. In addition, each must be on the font path. 

The directories described here are subdirectories of the system directory. 

Scalable Font Directories 

The fonts/if O.St directory is the default font catalog. It contains typeface 
files, licensing, and metrics information. 

Licenses Subdirectory. The fonts/ifo.st/licenses directory contains file 
with licensing information for each host, display, and system. 

It contains a hosts.dir file, which is a cross-reference between the actual host 
name and the directory containing license information about that host. One 
host subdirectory is STSYSTEM, which is for system-wide licenses. There are 
separate subdirectories for each host on the system. 

Within each host subdirectory, there are subdirectories for each device 
(DISPLAYS is always one). Within these directories there are fonts. dir and 
fonts. alias files as described elsewhere in this manual. 

Metrics Subdirectory. The fonts/if o.st/metrics directory contains metrics 
for the fonts and scalable typefaces that are not loaded on the system. This is 
the recommended location for the .tmf files for LaserJet bitmap fonts. 

Products Subdirectory. Each product that has been installed has a file 
cross-referencing the font file name and the XLFD name used to refer to it. 
The core fonts are in a the built in file. 

Typefaces Subdirectory. The fonts/ifo.st/typefaces directory contains the 
typeface files. These files have a . if o extension. There is a fonts .dir file for 
each typeface directory. 
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Administrative Directories 

The fonts /stadmin/ if o directory contains typef aces.dir, which provides a 
cross-reference between the typeface ID and the XLFD name. 

The f onts/stadmin/if o/charsets subdirectory contains valid character 
sets. These files have a . sjrni extension and are in the same format at those 
for TypeDirector/DOS 3.0. A charsets.dir file provides a cross-reference 
between the file name and the character set name. Non-active character sets 
are contained in the subdirectory archive, with its own charsets.dir file. To 
make an inactive character set active, copy it from the archive subdirectory, 
and update the charsets.dir file by running stmkdirs on that directory. 

The directories do not have to be physically present on every system. There 
may be a master copy on one system and NFS links to other systems. Font 
administration should be performed on the NFS server for the typeface 
directories. 

Making Bitmapped Fonts from Scalable Typefaces with 'stmkfont' 

If you use a particular scalable typeface often, it is more efficient to turn it into 
a bitmapped font, rather that recreating it each time you want it. 

The stmkf ont utility produces bitmapped fonts in a variety of formats from an 
outline specified by an XLFD name, stmkf ont can create bitmap fonts in the 
following formats: 

scf Server Compressed Format 

snf Server Natural Format 

bdf Bitmap Distribution Format 

PCL Printer Command Language (for HP LaserJet printers) 

PCLEO Printer Command Language Encapsulated Outlines (for HP 

LaserJet III printers). 
IFO Intellifont outline. 

TFM HP Tagged Font Metric for metrics pertaining to HP LaserJet 

printer scalable typefaces. 

The syntax for stmkf ont is: 

stmkf ont [ options] xlfdname 
where the options are: 
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-dipath Specifies the primary database tree path (default is 

fonts/if o.td). 

-d2 path Specifies the secondary database tree path (default is 

fonts/td). 

-dv device Specifies the device for which the font is to be made. 

-cp path Specifies the charset path (default is char sets). 

-cf file Specifies the charset file (default is to derive it from the XLFD 

name. 

-nf file Specify a new name for fonts . dir. 

-ns file Specify a new name for charsets . dir. 

-nt file Specify a new name for typefaces .dir. 

-nv name Specify an environment variable to use instead of STPATH. 

-o outfile Specifies output file (default is stdout) 

-B progname Specifies an alternative BDF-to-SNF converter utility to be run 
in place of bdftosnf. 

-b string Specifies BDF-to-SNF converter command line arguments. 

-f format Specifies the output format (BDF (default), SNF, PCL, or 

PCLEO). 

-I Send completion status information to stderr. 

-P Send 1% progress dots to stderr. 

-C Send catalog of XLFD/symbol set combinations to stderr. 

-T Bypass intermediate tempfile, write to output directly. 

-V Send fully qualified XLFD name to stderr, then quit. 

-V Send fully qualified XLFD name to stderr, then continue. 

-w Supress bitmaps, restrict output to header and trailer only. 

-q Suppress error messages (quiet mode). 
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xlfdname This parameter is required. Since both the XLFD name and 

parameters start with a dash (-), then stmkf ont assumes the 
last arguments is the XLFD name. 

The XLFD name must not contain any blanks. If it does, enclose the entire 
string in quotes ("). Empty fields and wildcards are permitted. 

For example, 

stnkfont -o Hyfont -x "-agfa-cg century sdioolbook-normal-r-nomal 240 p-150-*-ro«an8" 



Converting Map Formats with 'stconv' 

The stconv utility converts symbol set maps ( . sjrm files) from one symbol set 
to another. Output is always to stdout. 

The syntax for stconv is: 

stconv infile [-hmq] [-d mapdir] [-to format] 
where: 

Name of the . sjrm file to be converted. 



infile 

-d mapdir 



-to format 



Specifies the name of the directory containing the symbol 
conversion list. This directory should contain the file 
acg.hpmsl and any optional additional symbol set maps. The 
default is /f onts/stadmin/if o/charsets in your system 
directory. 

Specifies the new symbol list format. The default is hpmsl. 
To generate a symbol set for Agfa/Compugraphics character 
codes, specify -to ACG. 



-m 



Lists the conversion map. 
Run quietly. 
Requests help. 



-q 

-h 

For example, 

stconv -to ACG romanS.sym 
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reads the HPMSL symbol map romanS . sym, and writes the AGC version to 
stdout. 



Using Native Language Input/Output 

Note This section does not apply to the OSF/1 operating system. 



4 



Though most character sets are composed of 8-bit characters, some languages 
(Japanese, Chinese, and Korean) have larger character sets that require 16-bit 
characters. The X Window System supports the use of 16-bit character input 
with the Native Language Input/Output (NL I/O) subsystem. 

Requirements for Using NL I/O 

To use NL I/O you must have the following: 

■ The NL I/O subsystem properly installed on your system. 

■ The appropriate language keyboard or an ASCII keyboard. A client that 
uses XHPSetKeyboardMapping allows NL I/O to be used with any language 
HP keyboard. 

X clients use the KBD.LANG environment variable to determine which 
keyboard language to pass to KHPSetKeyboardMapping. 

■ The appropriate NL I/O fonts installed in the fonts subdirectory of your 
system directory: 

f onts/hp_ j apanese/ 

fonts/hp_chinese.s/ 

fonts/hp_chinese_t/ 

fonts/hp_korean/ 

fonts/hp.katakana/ 

For more information on native language configuration, refer to "Customizing 
for Native Language Support" in chapter 3. 
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specifying an NL I/O Font 

NL I/O fonts are part of the NL I/O product. They are installed in the 
subdirectories of fonts subdirectory of your system directory when you install 
your NL I/O subsystem. 

You specify an NL I/O font exactly like you specify any other font. For 
example, if you want to create an hpterm window that uses the Japanese font 
jpn.8xl8, use the following command line: 

hpterm -fn jpn.8xl8 
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The Window Manager 



The OSF/Motif Window Manager (mwm) is an Xll client that manages the 
appearance and behavior of objects on the root window. You control mwm and 
its management functions using a mouse, keyboard, and a functional window 
frame. Additionally, mwm has a root menu to assist you in the control of the 
root window. 

Chapter 4 explains how to use windows. This chapter explains how to 
customize them. 

This chapter organizes window manager resources and functions into the 
following task-oriented topics: 

■ Starting and stopping mwm. 

■ Setting mwm resources using .mwmrc 

■ Managing the general appearance of window frames. 

■ Working with icons. 

■ Managing window manager menus. 

■ Using the mouse. 

■ Using the keyboard. 

■ Controlling window size and placement. 

■ Controlling focus policies. 
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starting and Stopping the Window Manager 

The OSF/Motif Window Manager (mwm) is an XI 1 client that manages the 
appearance and behavior of objects on the root window. You control mwm 
and its management operations using a mouse, a keyboard, and a functional 
window frame. Additionally, mwm has a root menu to assist you in the general 
control of the root window. 

The OSF/Motif Window Manager is the default window manager for your X 
Window System. It is started from $HOME/.xllstart when you start Xll. 
If that file doesn't exist, mwm is started from sys.xllstart in your system 
directory. 

The syntax for mwm is as follows: 

-display host: display. screen' 
-xrm resourcestring 
mwm -multiscreen 
-name name 
-screens name [name ...J 

where: 

-display Specifies the screen to use. 

-xrm Specifies using the named resource on starting. 

-multiscreen Causes mwm to manage all screens on a display. The default is 
to manage only a single screen. 

-name Uses name to retrieve resources. 

-screens Gives the resource names for the screens managed by mwm. The 

names are separated by spaces. 

The following line in .xl 1st art in your home directory starts mwm. 

mwm $Q ft 

The $Q passes the window manager options specified on the xllstart 
command line. 
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Declaring Resources 

The mwm client receives configuration information from three resource files: 

■ sys.Xdefaults in the system directory or .Xdefaults in your home 
directory. 

Contains X resources. 

■ system.mwmrc in the system directory or .mwmrc in your home directory. 
Menus, key bindings, and button bindings. 

■ app- defaults /Mwm in the system directory. 

X resources for mwm only. 

This file cannot be changed. However, you can copy information from that 
file, modify it, and then add it to your personal resource. 

If you modify these files, you can use either method of specifying personal 
resources: changing the RESOURCE-MANAGER property or modifying the 
.Xdefaults file. Both methods are covered in chapter 5. 

The syntax you use differs depending on whether you want the resource to 
control an element or that element for a particular object. 



The syntax for mwm resources is: 

?.«5 I 1 

^resource: value 



[{ clientname clientclass 1 
\deJ 



defaults J 



Use nothing between "Mwm" and the resource name if you want the resource 
applied to all clients for which you don't otherwise specify a value. Some 
resources make sense only at this level, such as the focus policy ones. Use 
clientclass to apply the resource to a specific class of clients. Use clientname 
to apply the resource only to a specific instance of a client named using the 
client's name resource. Use defaults when you want the default value used. 
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For example, if you want the general appearance of the clients in your 
environment to be SteelBlue and VioletRed, but want your menus to be 
different, you could use the following lines in your personal resources. 

Mwm*backgroimd: SteelBlue 

Mwm*foreground: VioletRed 

Mwm*activeBackground: VioletRed 

Mwm*activeForeground: SteelBlue 

Mwm*menu*background: SkyBlue 
Mwm*menu*foreground: White 

Or, if you want to use your own happyf ace bitmap for hpterm windows and 
see a complete label whenever any icon is active, you would have the following 
lines in your personal resources: 

Mwm*Hpterm*iconImage : /users/yoMrwsername/Bitmaps/f ace .bits 
Mwin*iconDecoration: label activelabel 
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Frames 

You can control the general appearance of the window frames in your 
environment with your personal resources specifications. 

Parts of a Window Frame 

Three aspects of the general appearance of window frames are under your 
control. 



Color 



Tile 



Font 



The color of foreground, background; and top, bottom, and 
side shadows. 

The mixture of foreground and background color that 
composes the pattern of the frame surface. 

The style (including size) of the text characters in the title bar, 
menus, and icon labels. 



Additionally, you can control what parts of the frame are displayed. 



I — Window Menu 
I— Title Bar 



Prompt 



Pointer 



Resize 
Border 




j — Minimize 
I I — Maximize 
l-fL 

Li 



Figure 7-1. Frame Elements 
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Customizing the Window Frames 

You can specify what frame components you want to appear on windows: 

■ The clientDecoration resource enables you to choose just how much or 
how little "decoration" you want to put around each client. 

■ The transientDecoration resource enables you to choose just how much 
or how little decoration you want to put around each transient window. A 
transient window is a relatively short-lived window, for example, a dialog 
box. 

You can still access the functionality of any decoration you remove by binding 
its functions to mouse buttons or to key presses, as explained in "Mouse 
Button Bindings" later in this chapter. 

Table 7-1. Valid Window Frame Elements 



Frame Element 


Description 


all 


Include all frame elements (default value). 


none 


Include no window frame elements. 


iborder 


Window border. 


imaximize 


Maximize button (includes title bar). 


iminimize 


Minimize button (includes title bar). 


±none 


Include no window frame elements. 


dbresizeh 


Resize border handles (includes border). 


itmenu 


Window menu button (includes title bar). 


ititle 


Title bar. 



You specify the clientDecoration and transientDecoration resources as 
a list of the frame elements. If the first element in the list is preceded by a 
plus (+) sign or has no sign preceding it, the window manager starts with no 
frame and assumes that the list contains those elements you want added. If the 
list begins with a minus (— ) sign, the window manager starts with a complete 
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frame and assumes that the list contains elements you want removed from the 
frame. 

For example, you may want a border with only a title bar and window menu 
button around a particular hpterm window started as hpterm -name hp850. 

Mwm*hp850*clientDGCoration: +mGnu 

Or you could remove the title bar from all transient windows by adding the 
following line in your personal resources specification: 

Mwm*transiGntDecoration: —title 



Coloring Window Frame Elements 

You can use any of the standard XI 1 colors listed in the rgb.txt file in your 
system directory to color frame elements. In addition, you can create your own 
colors using hexadecimal values (see "Color Resources" in chapter 5). 

The following table lists the individual elements of inactive and active window 
frames, and the resources that control their color, for mwm. 

The default settings provide a 3-D visual effect without you having to specify 
the exact colors for every frame element. 



The Window Manager 7-7 



Table 7-2. Window Frames Resources for a Color Display 



To color this . . . 


Use this resource . . . 


The default value is . . . 


Background of inactive 
frames. 


background 


LightGrey 


Left and upper bevel of 
inactive frames. 


topShadovColor 


Lightened background 
color 


Right and lower bevel of 
inactive frames. 


bottomShadowColor 


Darkened background color 


Foreground (title bar text) 
of inactive frames. 


foreground 


Darkened 
bottomShadowColor 


Background of the active 
frame. 


act i veBackground 


CadetBlue 


Left and upper bevel of the 
active frame. 


act i veTopShadowColor 


Lightened 
activeBackground color 


Right and lower bevel of 
the active frame. 


activeBottomShadowColor 


Darkened 
activeBackground color 


Foreground (title bar text) 
of the active frame. 


act iveFor eground 


Darkened 
activeBottomShadowColor 



For example, the following lines in the .Xdef aults file in your home directory 
give the window manager frame a maroon foreground and a gray background. 
The background color is used to generate colors for the top and bottom shadow 
elements so that a 3-D effect is achieved. 

Mwm*f oreground : Maroon 
Mwm+background: Gray 
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Tiling Window Frames With Pixmaps 

A pixmap can be used to create shades of colors. Each pixmap is composed of 
tiles. A tile is a rectangle that provides a surface pattern or a visual texture by 
"mixing" the foreground and background colors into a color pattern. 

Table 7-3. 
Tiling Window Frames with Window Manager Resources 



To tile this .. . 


Use this resource . . . 


The default for 
color displays is . . . 


Background of inactive 
frames. 


backgr oundP ixmap 


NULL 


Right and lower bevels of 
inactive frames. 


bottomShadowPixmap 


NULL 


Left and upper bevels of 
inactive frames. 


t opShadowP ixmap 


NULL 


Background of the active 
frame. 


activeBackgroundPixmap 


NULL 


Right and lower bevels of 
the active frame. 


act iveBottomShadowP ixmap 


NULL 


Left and upper bevels of 
the active frame. 


act iveTopShadovP ixmap 


NULL 
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The following table lists the acceptable values for pixmap resources: 
Table 7-4. The Values to Use for Tiling Window Frames 



To tile an element this color . . . 


Use this 
value ... 


The foreground color. 


foreground 


The background color. 


background 


A mix of 25% foreground to 75% background. 


25_foreground 


A mix of 50% foreground to 50% background. 


50 -foreground 


A mix of 75% foreground to 25% background. 


75 -foreground 


In horizontal lines alternating between the foreground and 
background color. 


horizontal-tile 


In vertical lines alternating between the foreground and background 
color. 


vertical-tile 


In diagonal lines slanting to the right alternating between the 
foreground and background color. 


slant-right 


In diagonal lines slanting to the left alternating between the 
foreground and background color. 


slant-left 
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The following figure illustrates the valid tile values: 



\ foreground | 




background 



I 25 foreground 



I.IJI.....I. „J!.IJ.^.I...^,.....l. 



I 50_foreground ] | 75_f or aground ] I hortzontal_ti le j 




I vertical_ti le 1 | slant_right ~j | slant_left ~| 





Figure 7-2. Valid Tile Values 



Matting Clients 



A matte is a 3-D border just inside the window between client area and 
window frame. 

The following table lists matte elements and the resources that control their 
color. 
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Table 7-5. 
Coloring Window Frames with Window Manager Resources 



To color this . . . 


Use this resource . . . 


The default value is . . . 


Width of matte 


matteVidth 


(no matte) 


Matte background. 


matt eBackgr ound 


mvm background 


Left and upper bevel of 
matte. 


matt eTopShadowColor 


Lightened 

matt eBackgr ound color. 


Right and lower bevel of 
matte. 


matteBottomShadowColor 


Darkened 
matteBackground color. 


Matte foreground. 


matt eFor eground 


Darkened 
matteBottonShadowColor. 


Matte right and lower 
bevels. 


matteBottomShadowPixmap 


client bottom shadow color 


Matte left and upper 
bevels. 


matteTopShadowPixmap 


client top shadow color 



The values to use for tiling mattes are shown in Table 7-4. 

For example, you could place a different matte around hpterm and xterm 
windows by including the following lines in your personal resources 
specifications: 

Mwm*HPterm*matteWidth: 10 

Mwm*HPterm*matt eBackgr oimd: SkyBlue 

Mwm*XTerm*matteWidth: 10 

Mwm*XTerm*matteBackground: Tan 

Frame Resources For Monochrome Displays 

If mwm determines that the monitor is monochrome, and no color resources are 
specified for frame elements, mwm uses defaults appropriate for monochrome 
displays. Mwm*background and Mwm*activeBackground are set to White. The 
following table lists the frame elements, resources, and defaults for monochrome 
monitors. 
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Table 7-6. 
Window Frame Resource Values for Monochrome Monitors 



The background is . . . 


For this resource . . . 


The default value is . . . 


White 


topShadowColor 


White 


White 


bottomShadowColor 


Black 


White 


foreground 


Black 


White 


t opShado wP ixmap 


foreground 


White 


act i veBackgr otindP ixmap 


foreground 


White 


act iveTopShowdowPixmap 


50_foreground 



The sys.Xdefaults file contains a set of entries that provides a more 
attractive window shading for monochrome displays. These entries start with 
mwm.bw, and require that you start mwm with the name mwm.bw. To do this, edit 
the following line in .xl 1st art: 

mwm k #Starts the mwm window manager 
to read: 

mwm -name mwm.bw & #Starts the mwm window manager 

You must restart XI 1 in order for this change to take effect. 

When you start the window manager with a new name, it will no longer see 
resources of the form mwm* resource. It will see the class resources Mwm*re50wrce. 
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Specifying a Different Font for the Window Manager 

The default font for the text of the OSF/Motif Window Manager is the fixed 
font. However, you can use the f ontList resource to specify a different font 
if you desire. The f ontList resource can use any valid Xll font name as its 
value. For more information about fonts, see chapter 6. 



Worlcing witli Icons 

Icons provide a handy way to straighten up a cluttered workspace. 



Window 
Manager 
Frame 



Image 



Label 




hptern 



Figure 7-3. The Parts of an Icon 



7-14 The Window l\Aanager 



An icon image (a bitmap) is the actual graphic illustration of the icon. An 
image can come from any one of the following three sources, listed in order of 
precedence: 

user You, the user, can specify an icon image using the iconlmage 

resource. 

client A client can use the WM_HINTS window property to specify 

either an icon window or a bitmap for the window manager to 
use as the icon image. 

default The window manager will use its own built-in default icon 

image if an image is not specified elsewhere. 

The window manager uses the following default order of precedence in choosing 
an icon image: 

The resource useClientlcon lets you interchange the precedence of 
user-supplied icon images and client-supplied icon images. The default value is 
"False." When the resource is set to "True," client-specified icon images have 
precedence over user- supplied icon images. 

Controlling Icon Placement 

By default, the window manager places icons in the lower left corner of the 
root window. Successive icons are placed in a row proceeding toward the right. 
Icons are prevented from overlapping. An icon will be placed in the position it 
last occupied if no icon is already there. If that place is taken, the icon will be 
placed at the next free location. 

The following three resources enable you to control the placement of icons: 
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Table 7-7. 
Controlling Icon Placement with Window Manager Resources 



To specify this . . . 


Use this resource . . . 


The default value is . . . 


A placement scheme for 
icons. 


iconPlacement 


left bottom 


The distance between 
screen edge and icons. 


iconPlacementMsurgin 


the default space between 
icons 


Automatic icon placement 
by the window manager. 


iconAutoPlace 


True 



The following table lists the icon placement schemes available to you: 
Table 7-8. Schemes for Automatic Placement off Icons 



If you want this icon placement . . . 


Choose this 
scheme . . . 


From left to right across the top of the screen. 


left top 


From right to left across the top of the screen. 


right top 


From left to right across the bottom of the screen. 


left bottom 


From right to left across the bottom of the screen. 


right bottom 


From bottom to top along the left of the screen. 


bottom left 


From bottom to top along the right of the screen. 


bottom right 


From top to bottom along the left of the screen. 


top left 


From top to bottom along the right of the screen. 


top right 



For example, if you want automatic placement of icons starting at the top of 
the screen and proceeding down the right side, you would have the following 
lines in your personal resource specifications: 

Mwm*iconPlacement: top right Specifies the placement scheme. 
Mwm*iconAutoPlace: True Specifies automatic placement. 
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Controlling Icon Appearance and Behavior 

mwm offers you a number of resources to control the specific appearance and 
behavior of icons. 

Selecting Icon Decoration 

Using the iconDecoration resource, you can select exactly what parts of an 
icon you want to display: 

Table 7-9. The Values That Control the Appearance of Icons 



If you want an icon that looks like this . . . 


Use this value . . . 


Just the label. 


label 


Just the image. 


image 


Both label and image. 


label image 


The label of an active icon isn't truncated. 


label activelabel 



Sizing Icons 

Each icon image has a maximum and minimum size, mwm has both default sizes 
as well as maximum and minimum allowable sizes. 

Table 7-10. The Maximum and Minimum Sizes for Icon Images 





Maximum Size 


Minimum Size 


Default 


50x50 pixels 


32x32 pixels 


Allowable 


128x128 pixels 


16x16 pixels 



How the window manager treats an icon depends on the size of the image in 
relation to the maximum and minimum sizes. 
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Table 7-11. Image Size Affects Icon Treatment 



If an icon image is . . . 


The window manager will . . . 


Smaller than the minimum size. 


Act as if you specified no image. 


Within maximum and minimum limits. 


Center the image within the maximum 
area. 


Larger than the maximum size. 


Clip the right side and bottom of the 
image to fit the maximum size. 



You can use the following two resources to control icon image size: 
Table 7-12. Controlling Icon Image Size 



To specify this . . . 


Use this resource . . . 


Maximum size of an icon image. 


i c onlmageMax imum 


Minimum size of an icon image. 


IconlmageMinimim 



Bear in mind that the overall width of an icon is the image width plus border 
padding and the image height is the icon height plus border padding. 

Using Custom Pixmaps 

When you iconify a client, either the client supplies its own icon image, the 
window manager supplies a default image, or you supply an image of your 
own — either "ready made" or one you create with the bitmap client. 

There are two resources that tell the window manager where custom icons are 
located: 

■ The iconlmage resource specifies the bitmap for a particular icon image. 
Its value is the path to the file containing the bitmap. If this resource is 
specified, it overrides any client-specified images. 

■ The bitmapDirectory resource causes the window manager to search a 
specified directory for bitmaps. The bitmapDirectory resource causes the 
window manager to search the specified directory whenever a bitmap is 
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named with no complete path. The default value for bitmapDirectory is 
/usr/include/Xll/bitmaps. 

Coloring and Tiling Icons 

A number of resources enable you to specify the colors of icon elements. 
Table 7-13. Coloring and Tiling Icon Resources 



To color this . . . 


Use this resource . . . 


Icon image background. 


iconlmageBackground 


Left and upper bevel of icon image. 


iconlmageTopShadowColor 


Right and lower bevel of icon image. 


iconlmageBottomShadowColor 


Icon image foreground. 


iconlmageForeground 


Right and lower bevels of an icon image. 


iconlmageBottomShadowPixmap 


Left and upper bevels of an icon image. 


iconlmageTopShadowPixmap 



Default values for these resources are the icon's bottom and top shadow 
pixmaps specified using the bottomShadowPixmap and topShandowPixmap 
resources set by the entries Mwm* icon* resource or Mwm*reso«rce. 

Using the Icon Box to Hold Icons 

The icon box allows you to use an icon box to contain icons, rather than 
having stand-alone icons on the workspace. 
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I — Location cursor 



I — Icon for normalized window 




. Icon for iconified window 

Figure 7-4. icon Box 

The icon box is a scrollable window that displays icons in a grid (rows and 
columns). Icons in the icon box do not overlap. If there are icons that cannot 
be displayed in the visible part of the icon box, you can scroll to see the icons. 
The sliders within the scroll bars show the extent of the icon grid that is 
visible. 

The icon box can be minimized (iconified) just like any other window. If the 
icon box is minimized, it is placed into the icon grid on the workspace. 

Specifying the Icon Box 

Several resources specify whether an icon box is used, define its geometry and 
location, and specify its name (for looking up resources) and title. 

■ The uselconBox resource specifies whether or not an icon box is used. A 
value of of "True" places icons in an icon box. The default value of "False" 
places icons on the root window. 

■ The iconBoxGeometry resource sets the initial size and placement of the icon 
box. If the iconBoxGeometry resource is used, the largest dimension of the 
size determines if the icons are placed in a row or a column. The default 
policy is to place icons in a row going from left to right, top to bottom. 
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The value of the iconBoxGeometry resource is a standard window geometry 
string with the following syntax: 

- Width X Height [± x ± y] 

If X and y are not provided, the icon box is placed at +0—0. 

The actual size of the icon box window depends on the iconlmageMaximum 
(size) and iconDecoration resources. The default value for size is (6 * 
icon Width + padding) wide by (1 * iconHeight + padding) high. 

■ The iconBoxNamG resource specifies the name that is used to look up icon 
box resources. The default name is "iconbox." 

■ The iconBoxTitle resource specifies the name that is used in the title area 
of the icon box frame. The default name is "Icons." 

For example, the following line specifies that icons will be placed in an icon 
box: 

Mwm*usGlconBox: True 

Controlling the Appearance of Icon Boxes 

The icon box is displayed in a standard window management client frame. 
Client-specific resources for the icon box can be specified using "iconbox" as 
the client name. 

Mwm* iconbox* resource : value 
Resources that can be used with the icon box to change its appearance are: 

■ iconDecoration. 

■ The mwm resources dealing with mattes and icon appearance. (The icon 
appearance resources affect the icon displayed when the icon box is 
minimized.) 
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The Icon Box Window Menu 

The window menu for the icon box differs from the standard window menu in 
that it does not contain the "Close" selection. In its place is the "Packlcons" 
selection, which shifts icons to fill empty spaces in the icon placement grid so 
that the icons appear in neat, complete rows. 

Controlling Icons in the Icon Box 

Every client window that can be iconified has an icon in the icon box, even 
when the window is in the normal state. The icon for a client is put into the 
icon box when the client becomes managed by the window manager, and is 
removed from the icon box when the client stops. 

Icons for windows in the normal (open) state are visually distinct from icons 
for windows that are iconified. Icons for windows that are iconified look like 
stand-alone icons. Icons for windows that are in the normal state appear flat 
and are optionally grayed-out. The value of "True" for the f adeNormallcon 
resource grays out icons for normalized windows. The default value is "False." 

The text and image attributes of icons in icon boxes are determined in the 
same way as for stand-alone icons, using the iconDecoration resource. 

A standard "control" location cursor is used to indicate the particular icon 
in the icon box to which keyboard actions apply. The location cursor is an 
unfilled rectangle that surrounds the icon. 

Icons contained in the icon box can be manipulated with the mouse and from 
the keyboard. Mouse button actions apply whenever the pointer is on any part 
of the icon. 
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Table 7-14. Controlling Icons in the Icon Box With a Mouse 



If you want to . . . 


Do this . . . 


Select an icon. 


Press button 1. 


Normalize (open) an iconified window. 


Double-click mouse button 1. 


Raise a normalized window to the top of 
the stack. 


Double-click mouse button 1. 


Move an icon within the icon box. 


Drag button 1. 



To manipulate an icon from the keyboard, make the icon box the active 
window and use the arrow keys to traverse the icons in the icon box. Pressing 
[Return) does the default action for the selected icon: for an icon of a normalized 
window, the window is raised; for an icon of an iconified window, the window is 
normalized. The arrow keys move the focus around the icons that are visible. 
The (Tab) key moves the keyboard input focus around the box in this order: 
icons, horizontal scroll bar, vertical scroll bar, icons, (shift) (Tab) moves the focus 
in the opposite direction. 
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Managing Window l^anager l^enus 

The OSF/Motif Window Manager menus are defined by a text file in your 
system directory called system.mwmrc, unless you have a file in your home 
directory called .mwmrc. You can add or delete menus and menu selections by 
copying system.mwmrc to your home directory as .mwmrc and modifying it to 
suit your needs. 

Default Menus 

The OSF/Motif Window Manager comes with two default menus: 

Default Window Menu 

The default window menu is built into mwm. For reference, a copy of its 
contents are placed in .mwmrc. 



Menu Def aultWindowMenu 
r 






1 

"Restore" 


_R 


Alt<Key>F5 


f .normalize 


"Move" 


_M 


Alt<Key>F7 


f .move 


"Size" 


-S 


Alt<Key>F8 


f .resize 


"Minimize" 


_n 


Alt<Key>F9 


f .minimize 


"Maximize" 


-X 


Alt<Key>F10 


f .maximize 


"Lower" 


_L 


Alt<Key>F3 


f .lower 


no-label 






f . separator 


"Close" 

> 


_C 


Alt<Key>F4 


f.kill 



By default, the window menu displays when you do the following operations: 

■ Press button 1 on a window frame's window menu button. 

■ Press button 3 anywhere on a window frame. 

■ Press (Shift) (Esc) with the keyboard focus set to a window. 



The windowMenu resource must be set in order to replace the 
Def aultWindowMenu with a different menu. 
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Default Root Menu 

The default root menu is specified in the same files by the following lines: 



Menu RootMenu 

"Root Menu" 
"New Window" 
"Start Clock" 
"Start Load" 
"Shuffle Up" 
"Shuffle Down" 
"Refresh" 
no-label 
"Restart. . ." 
> 



f .title 

f .exec "hpterm ft" 

f .exec "xclock -geometry 100x90-1+1 ft" 

f .exec "xload -geometry 150x90-130+1 ft" 

f .circle.up 

f .circle.down 

f .refresh 

f .separator 

f .resteirt 



By default, the root menu displays when you press button 3 on the root 
window. 



Modifying Menus 

You can modify either menu to suit the specific needs of your application; 
however, for the sake of the consistency of window operation, it's usually better 
to modify the root menu and keep the window menu the same. 

All window manager menus, regardless of the mechanism that calls them to the 
screen, have the same syntax. 



Menu Syntax 

Menu MenuName 

i 

selectionl [.mnemonic] [.accelerator] 
selectionB [mnemonic] [accelerator] 
selections [mnemonic] [accelerator] 



function [argument] 
function [argument] 
function [argument] 



selection* [mnemonic] [accelerator] function [argument] 
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Each line identifies a selection name followed by the function to be done if that 
selection is chosen. The order of the selections is the order of their appearance 
when you display the menu. A selection name may be either a character string 
or a bitmap. 

Selections 

Any character string containing a space must be enclosed in double quotes 
(""); single- word strings don't have to be enclosed, but it's probably a good 
idea for the sake of consistency. An alternate method of dealing with two- word 
selection names is to use an underbar (_) in place of the space. 

You can create a bitmap with the bitmap client and use it as a selection name. 
The syntax for doing this is as follows: 

^/ path/ bitmapjile function [ argument^ 

Note the at-sign (@) in the above line. The at-sign tells the window manager 
that what follows is the path to a bitmap file. 

Menu Titles 

The f .title functions creates a menu title, and automatically places a 
separator above and below the title. 

Mnemonics and Accelerators 

You have the option of using a mnemonic and accelerator with a menu 
selection. A mnemonic is specified using the syntax: 

mnemonic = ^character 

An accelerator is specified using keyboard binding syntax described later in this 
chapter (see "Keyboard Binding Syntax"). 

Functions 

Each function operates in one or more of the following contexts: 

root Operates the function when the root window is selected. 

icon Operates the function when an icon is selected. 
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window Operates the function when a client window is selected. 

Additionally each function is triggered by one or more of the following devices: 

Button Button binding (mouse). 

Key Key binding. 

Menu Window manager menu. 

Any selection that uses an invalid context, an invalid function, or a function 
that doesn't apply to the current context is grayed out. This is the case with 
the "Restore" selection of a terminal window's system menu or the "Minimize" 
selection of an icon's window menu. 

The following table lists the valid functions, contexts, and devices. 
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Table 7-15. Valid Window Manager Functions 



Functions 


Contexts 


Devices 


Name 


Description 


Root 


Icon 


Window 


Button 


Key 


Menu 


f.beep 


Causes a beep to 
sound. 


y 


a/ 


x/ 


y 


>/ 


V 


f.circle_down 


Puts window on 
bottom of stack. 


y 


V 


y 


V 


V 


V 


f.circle_up 


Puts window on top of 
stack. 


V 


V 


y 


y 


%/ 


V 


f.exec 


Uses /bin/sh to 
execute a command. 


v 


^/ 


y 


V 


^ 


V^ 


f. focus- color 


Sets colormap focus 
when colormap focus 
policy is explicit. 


y 


y 


>/ 


y 


y 


y 


f.focus_key 


Sets keyboard input 
focus when keyboard 
focus policy is explicit. 


y 


y 


V 


y 


V 


y 


f.kill 


Terminates a client's 
connection to server. 




V 


>/ 


y 


y 


V 


f.lower 


Lowers a window to 
bottom of stack. 




y 


V 


V 


V 


%/ 


f.maximize 


Enlarges a window to 
its maximum size. 




y 


>/ 


y 


y 


V 


f.menu 


Associates a menu with 
a selection or binding. 


y 


y/ 


V 


V 


%/ 


V 


f.minimize 


Changes a window into 
an icon. 






V 


V 


V 


V 


f.move 


Enables the interactive 
moving of a window. 




y 


V 


y 


y 


v 
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Table 7- 15a. V^lid Window Manager Functions (continued) 



Functions 


Contexts 


Devices 


Name 


Description 


Root 


Icon 


Window 


Button 


Key 


Menu 


f.next_cmap 


Installs the next 
colormap in the 
window with the 
colormap focus. 


V 


^ 


^ 


y 


>/ 


>/ 


f.next_key 


Sets keyboard focus 
policy to the next 
window/icon in the 
stack. 


v 


y 


V 


>/ 


v/ 


v/ 


f.nop 


Does no function. 


v 


^/ 


V 


y 


>/ 


V 


f.normalize 


Displays a window in 
normal size. 




y 


^/ 


y 


y 


y 


f.pack-icons 


Packs icons rows in the 
root window or icon 
box. 


y 


y 


V 


V 


x/ 


y 


f.pass_keys 


Toggles between 
enabling and disabling 
processing of key 
bindings. 


V 


y 


V 


^ 


>/ 


y 


f.post_wmenu 


Posts the window 
menu 


V 


>/ 


y 


n/ 


V 




f.prev_cmap 


Installs the previous 
color map in the 
window with the 
colormap focus. 


V 


V 


y 


^/ 


v 


x/ 


f.prev_key 


Sets the keyboard 
input focus to the next 
window/icon in the 
stack. 


v 


^/ 


y 


V 


>/ 


V 
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Table 7- 15b. Valid Window Manager Functions (continued) 




Functions 


Contexts 


Devices 


Name 


Description 


Root 


Icon 


Window 


Button 


Key 


Menu 


f,quit_mwm 


Terminates OSF/Motif 
Window Manager, but 
not X. 


y 






V 


y 


y 


f. raise 


Lifts a window to the 
top of the window 
stack. 




y 


V 


V 


y 


V 


f.raise_lower 


Raises a partially 
concealed window; 
lowers an unconcealed 
window. 




V 


V 


y 


y 


V 


f. refresh 


Redraws all windows. 


y 


y 


%/ 


y 


>/ 


V 


f.refresh_win 


Redraws a client 
window. 






V 


>/ 


v/ 


>/ 


f. resize 


Enables you to 
interactively resize a 
window. 






V 


y 


y 


V 


f. restart 


Restarts the 
OSF/Motif Window 
Manager. 


>/ 






y 


y 


y 


f.send_msg 


Sends a client message. 




y 


y 


y 


y 


y 


f.separator 


Draws a line between 
menu selections. 


>/ 


^/ 


V 






y 


f.set-behavior 


Restarts mwm with CXI 
or custom behavior. 


y 


y 


%/ 


y 


v/ 


%/ 


f.title 


Inserts a title into a 
menu at the specified 
position. 


>/ 


^ 


V 






V 
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Changing the Menu Associated with the Window Menu Button 

The windowMenu resource lets you change the menu displayed when you press 
button 1 on the window menu button. 

For example, you would place the following line in your personal resource 
specifications to associate a menu named EditMenu with an hpterm window 
started as hpterm -name hp850. 

Mwm*hp850*windowMGnu : EditMenu 



Mouse Button Bindings 

The window manager recognizes the following button operations: 

Press Holding down a mouse button. 

Click Pressing and releasing a mouse button. 

Double-click Pressing and releasing a mouse button twice in rapid 
succession. 

Drag Pressing a mouse button and moving the pointer (and mouse 

device). 

You associate a button operation with a window management function using a 
button binding. A button binding is a command line you put in the .mwmrc file 
that associates a button operation with a window manager function. 

Default Button Bindings 

The OSF/Motif Window Manager comes with the following built-in button 
bindings. 
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Table 7-16. Built-in Button Bindings 



Location of Pointer 


Behavior 


Window menu button 


Pressing button 1 displays the window menu. This 
behavior can be modified by the wMenuButtonClick 
resource. 


Window menu button 


Double-clicking button 1 closes the window. This 
behavior can be modified by the wMenuButtonClick2 
resource. 


Minimize button 


Clicking button 1 minimizes the window. 


Maximize button 


Clicking button 1 maximizes the window. 


Title bar 


Dragging button 1 moves the window. 


Window or icon 


Pressing button 1 gives it keyboard focus. 


Resize border 


Dragging button 1 resizes the window. 


Icon 


Clicking button 1 displays the icon window menu. This 
behavior can be modified by the iconClick resource. 


Icon 


Double-clicking button 1 normalizes the window. 


Icon 


Pressing button 1 moves the icon. 



These bindings are fixed — they cannot be replaced by other bindings. 
However, you can add to some of them (see "Modifying Button Bindings and 
Their Functions.") For example, you can specify an additional function for 
double- clicking button 1 in an icon, but the double click will also normalize the 
window. 

Mwm provides an additional default binding that can be deleted or replaced: 
Table 7-17. Additional Button Bindings 



Locaton of Pointer 


Behavior 


Icon or Frame 


Pressing button 1 raises the window or icon. 
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This binding is listed in the following section of the .mwmrc file. 

Buttons DefaultButtonBindings 

{ 
<BtnlDown> icon I frame f. raise 

> 

The binding can be removed or altered by deleting or editing the line that 
begins with <BtnlDown>. (In order for the editing to have an effect, the 
buttonBindings resource must be set to DefaultButtonBindings, and you 
must restart the window manager.) 

Modifying Button Bindings and Their Functions 

You can modify the button bindings section of your .mwmrc file to suit your 
individual needs. 

Button Binding Syntax 

The syntax for button bindings is as follows: 

Buttons ButtonBindingSetName 
i 

button context] context function targumenf] 

button context] context function [.argumenf] 

button context] context function largument'] 

y 

The following button binding contexts are recognized by the window manager: 

root Operates the function when the button is activated in the root 

window. 

window Operates the function when the button is activated in a client 

window or window frame. 

frame Operates the function when the button is activated on a 

window frame. 

icon Operates the function when the button is activated on an icon. 

title Operates the function when the button is activated on a title 

bar. 
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app Operates the function when the button is activated in a client 

window (excludes window frames). 

Modifying Button Bindings 

Button bindings can be modified by: 

■ Editing the Def aultButtonBindings section of .mwmrc. 

■ Making a new button binding set. 
To create a new button binding set: 

1. Edit the .mwmrc file to include a new key binding set with a unique name. 

2. Set the buttonBindings resource in your .Xdef aults file to the new name. 

iVIodifying Button Cliclc Timing 

The OSF/Motif Window Manager has another resource for controlling button 
behavior. This resource, doubleClickTime, sets the maximum time (in 
milliseconds) that can elapse between button clicks before a double-click 
becomes just "two clicks in a row." In other words, if two clicks occur in less 
than the maximum time, they are assumed to be a double-click; if two clicks 
occur in a time greater than the maximum time, they are assumed to be two 
single clicks. The default is 500 (milliseconds). 



Keyboard Bindings 

Similar to mouse button bindings, you can bind (associate) window manager 
functions to "special" keys on the keyboard using keyboard bindings. The 
window manager recognizes the following special keys: 

■ Shift. 

■ Escape. 

■ Alt (Meta or Extend Char). 

■ Tab. 

■ Ctrl. 

■ Lock. 
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Default Key Bindings 

The OSF/Motif Window Manager comes with the following default key 
bindings. 



Table 7-18. 
OSF/Motif Window Manager Default Keyboard Bindings 



When the keyboard 
focus is: 


Press: 


What this does is: 


Window or icon 




Displays window menu. 


(Shift) [Escape] 


Window or icon 




Displays window menu. 


[Alt] [space] 


Window, icon, or 
none 


(Alt) (lab J 


Switches keyboard focus to the next 
window or icon. 


Window, icon, or 
none 


(Alt) (Shift) (Tab) 


Switches keyboard focus to the previous 
window or icon. 


Window, icon, or 
none 




Switches keyboard focus to the next 
window or icon. 


(Alt) (Escape) 


Window, icon, or 
none 




Switches keyboard focus to the previous 
window or icon. 


(Alt) (Shift) [Escape) 


Window 


(Alt)(F6) 


Switches keyboard focus to the next 
window or icon, including transient 
windows. 


Window, icon, or 
none 


(Alt) (Ctrl) (Shift) (T) 


Restart mwm with default or custom 
behavior. 
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These keyboard bindings are listed in the following lines in system.mwmrc and 
.mwmrc. 



Keys Default KeyBindings 
{ 

Sliift<Key>E8cape 

Alt<Key>space 

llt<Iey>Tab 

Alt Sliift<Key>Tab 

ilt<Key>Escape 

Alt Shift<Key>E8cape 

Alt<Key>F6 



vindoB 
window I icon 
root I icon I window 
root I icon I window 
root I icon I window 
root I icon I window 
window 



Alt Ctrl Shift <Key>excla]ii root | icon [window 



f .post.waenu 

f .post.wnenu 

f . next_key 

f .preT_key 

f .next_key 

f .prev.key 

f .next.key transient 

f . set .behavior 



You can modify or delete any of these bindings, except "Alt Ctrl 

Shift <Key>excl am", by editing or deleting the line. (In order for the editing to 

have an effect, the keyBindings resource in the .Xdef aults file must be set to 

DefaultKeyBindings.) 

Modifying Keyboard Bindings and Their Functions 

You can modify the keyboard bindings section of your .mwmrc file if your 
situation requires it. 

Keyboard Binding Syntax 

The syntax for keyboard bindings is as follows: 

Keys KeyBindingSetName 
i 

key context] context function {.argument] 

key context] context function {.argumenf] 

key context I context function largumenf] 
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The following keyboard binding contexts are recognized by the window 
manager: 

root Operates the function when the key is pressed while the root 

window has keyboard focus. 

window Operates the function when the key is pressed while a client 

window has keyboard focus. 

icon Operates the function when the key is pressed while an icon 

has keyboard focus. 

Modifying Keyboard Bindings 

Key bindings can be modified by: 

■ Editing the Def aultKeyBindings section in .mwmrc. 

■ Making a new key binding set. 

To create a new keyboard binding set: 

1, Edit .mwmrc to include the new key binding set with a unique name. 

2. Set the keyBindings resource in your . Xdef aults file to the new nam^e. 



Controlling Window Size and Placement 

The following table lists window manager resources enabling you to refine your 
control over the size and placement of windows. 
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Table 7-19. 
Refining Your Controi with Window l\/lanager Resources 



To control this . . . 


Use this resource . . . 


The default is . . . 


Initial placement of new 
windows on the screen. 


int er act i vePlacement 


False 


The ability to enlarge windows 
beyond the size specified in 
maximumClientSize. 


limitResize 


False 


The maximum size of a client 
window set by user or client. 


max imumMax imumS iz e 


2 X screen 


The sensitivity of dragging 
operations. 


movelhreshold 


4 pixels 


Exact positioning of window 
and window frame. 


positionlsFrame 


True 


Clipping of new windows by 
screen edges. 


positionOnScreen 


True 


The width of the resize border 
of the window frame. 


r es izeBorderWidth 


10 pixels 


Displaying the resize cursors 
when the pointer is in the 
resize border. 


resizeCursors 


True 


The maximum size of a 
maximized client. 


maximumClientSize 


screen size 



The inter act i vePlacement resource has the following values: 

True The pointer changes shape (to an upper left corner bracket) 



False 



before a new window displays, so you can choose a position for 
the window. 

The pointer doesn't change shape. A new window displays 
according to the placement values specified in the X 
configuration files. 
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The limitResize resource has the following values: 

True A window cannot be resized to greater than the maximum 

size specified by the max imumCl lent Size resource or the 
WM_NORMAL_HINTS window property. 

False A window can be resized to any size. 

The value of the maximumMaximumSize resource is the widthxheight of the 
screen being used. The dimensions are given in pixels. For example, for an 
SRX display, maximumMaximumSize would have a value of 1280x1024. 

The value of the moveThreshold resource is the number of pixels that the 
pointer must be moved with a button pressed before a move operation is 
initiated. You can use this resource to prevent window or icon movement when 
you unintentionally move the pointer during a click or double-click. 

The positionlsFrame resource has the following values: 

True The position information (from WM_NGRMAL.HINTS and 

configuration files) refers to the position of the window frame. 

False The position information refers to the position of the window 

itself. 

The positionOnScreen resource has the following values: 

True If possible, a window is placed so that it is not clipped. If not 

possible, a window is placed so that at least the upper left 
corner of the window is on the screen. 

False A window is placed at the requested position even if it is 

totally off the screen. 

The value of the resizeBorderWidth resource is the width of the resize border, 
the outermost portion of the window frame. The width is. measured in pixels. 

The resizeCursors resource has the following values: 

True The appropriate resize cursor displays when the pointer enters 

a resize border area of the window frame. 

False The resize cursors are not displayed. 

The value of the maximumClientSize resource is the widthxheight (in pixels) 
of the maximum size of a maximized client. If this resource isn't specified, the 
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meLximum size is taken from the WM_NORMAL_HINTS window property, or the 
default size (the size of the screen) is used. 

For example, you might decide that xload clients should be maximized to no 
more than an eighth of the size of your 1024x768 display. 

Mwm*XLoad.maximiiiaClientSize: 128x96 



Controlling Focus Policies 

The focus policies determine what happens when a window becomes the active 
window. The active window is the window that has the focus of the keyboard 
and any extended input devices. When a window is active, the following are 
true: 

■ What you type appears in that window. 

■ The color of the window frame changes to indicate the active focus. 

■ Input from extended input devices goes to that window. 

Each focus policy is controlled by a specific focus policy resource. The focus 
policy resources are as follows: 

Table 7-20. 
Controlling Focus Policies with Window Manager Resources 



To control this . . . 


Use this resource , . . 


The default value is . . . 


Which client window has 
the colormap focus. 


colormapFocusPolicy 


keyboard 


Which client window has 
the keyboard and mouse 
focus. 


keyboEirdFocusPolicy 


explicit 
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The following focus policies are valid for the colormapFocusPolicy resource: 

keyboard The window manager tracks keyboard input and installs a 

client's colormap when the client window gets the keyboard 
input focus. 

pointer The window manager tracks the pointer and installs a client's 

colormap when the pointer moves into the client window or the 
window frame around the client. 

explicit The window manager tracks a specific focus-selection operation 

and installs a client's color map when the focus-selection 
operation is done in the client window. 

The following focus policies are valid for the keyboardFocusPolicy resource: 

pointer The window manager tracks the pointer and sets the keyboard 

focus to a client window when the pointer moves into that 
window or the window frame around the client. 

explicit The window manager tracks a specific focus-selection operation 

and sets the keyboard focus to a client window when the 
focus-selection operation is done in that client window. 

When the keyboard focus policy is explicit, you can use the passSelectButton 
resource to specify the consequence of the focus-selection operation. If 
you give passSelectButton a value of "True" (the default value), the 
focus-selection operation is passed to the client or used by the window manager 
to perform some action. If you give passSelectButton a value of "False," the 
focus-selection operation will be used only to select the focus and will not be 
passed. 

For example, you could change the keyboard focus policy so that moving the 
pointer into a window moved the focus there by adding the following line in 
your .Xdefaults file: 

Mwm*keyboardFocusPolicy: pointer 
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Switching Between Default and Custom Behavior 

The window manager has a buit-in key binding that allows you to switch back 
and forth between customized mwm behavior and default behavior. The key 
presses for doing this are (Alt) (shift) [ctri] Q. 

The following client-specific resources are affected by this function: 
cliGntDecoration clientFunctions focusAutoRaise windowMenu 



Using the Window Manager with IVIultiple Screens 

By default, the mwm manages one screen. Managing multiple screens can be 
specified in two ways: 

■ Using resources. 

■ Editing the startup command for mwm. 

Using Resources to Manage Multiple Screens 

The following resources configure the window manager to manage multiple 
screens: 

■ To specify that mwm manage multiple screens, use the resource: 

Mwm*multiScrGen: True 
This tells mwm to try to manage all screens that the server manages. 

■ To define the screen names, use the resource screenList. For example, the 
following resource names two screens zero and one. 

Mwm*screenList : zero one 
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specifying Multiple Screens from the Command Line 

You can use command-line options to start mwm so that it manages multiple 
screens. 

■ The -display option specifies the display. It has the syntax: 

-display hostname : display . screen 

u The -multiscreen option causes mwm to manage all the screens on the 
specified display. 

■ The -screens option specifies the screen names used to obtain screen- specific 
resources. 

For example, 

mwm -display local: 0.1 -multiscreen -screens zero one 

causes mwm to manage all the screens on display 0. Screens and 1 are named 
zero and one. 
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8 



Using the X Clients 



Programs running in the X environment can be divided into two groups: 

X clients "Window- smart" programs written for the X Window System. 

non-clients Programs written for terminals. Non-clients are run in 

terminal emulation windows. 

Related chapter: 

■ Chapter 5 covers setting resources for clients, client option, and the display, 
and geometry resources. 



Starting Clients and Non-clients 

Programs can run as either background or foreground processes. In any XI 1 
terminal window, you can run only one program as a foreground process, but 
you can run many programs as background processes. To run a program as a 
background process, add an ampersand (&) to the end of the command line 
that starts the program. 

The general syntax for the command line that starts a client is: 

client [ -options] [ & ] 

An & at the end of the command line causes the client to start as a background 
process. 
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Programs can be started: 

■ From the command line. 

The client name and options are typed after the command line prompt. 

■ From menus. 

Refer to chapter 7 for details of how to create your own menus. 

■ As part of the X startup. 

Refer to chapter 4 for information about the .xllstart file. 

Command-Line Options 

Command-line options override all default files. If no options are specified, the 
client is started using resource values from the resource database, the client's 
app-defaults, or from defaults built into the client. 

Some toolkit options are common to most clients: 

-fn font Specifies the font to use for the client. 

-bg color Specifies the background color. 

-f g color Specifies the foreground color. 

-display host -.display, screen Specifies the host where the client will 

display its output. 

-geometry widthx height Specifies the size of the window and its 

location. 

-help Displays an explanation of the options 

available for the client. 

For a specific client's options, refer to the client's man page in the Reference 
Section. 

Options have the syntax: 

-option argument 

For example, the following command line starts an hpterm window with a 
black background and white foreground: 
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hpterm -bg Black -fg White & 

Specifying the Display and Screen 

The default display on which a client is displayed is obtained from the DISPLAY 
environment variable of the system on which the client starts. It sets the host, 
display number, and screen number to which the client directs its output. This 
is typically display 0, screen 0. 

Most clients have a —display option that lets you set the host, display 
number, and screen on which the client will display its output. The -display 
option has the syntax: 

—display [host:display. screen] 



host The hostname of a valid system on the network. 

display The number of the display on the system on which you want 

the output to appear. A display can include more than one 
screen. 

screen The number of the screen where the output is to appear. The 

default is 0. 

For example, executing the command: 

hpterm —display hpxhere:0.1 & 

starts an hpterm process on the local system and displays the window on 
display 0, screen 1 of the hpxhere system. The window has the default size, 
location, and color. 
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starting Remote Programs 

A remote client is a client that runs on a computer other than the computer 
running the X server. In other words, a remote client runs on one computer 
while its output is displayed on another. 

There are several ways to run programs on a remote host from a command line: 

■ Use rlogin to log into the remote host. 

■ Use remsh to start a client remotely without formally logging in. (rsh for the 
OSF/1 operating system.) 

If the client produces output on a display, you must specify the display and 
screen on which you want the output to appear. 

Running Programs Using 'rlogin' 

You can use an existing terminal emulator window to log into a remote host. 
Once the window is acting as a terminal off the remote host, you can run 
clients there and direct the output to any display. 

For example, the following commands log into and start xload on remote host 
hpthere and display the output on local system hpxhere. 

rlogin hpthere 

xload -display hpxhere: 0.0 & 

Using 'remsh' to Start Programs 

The benefit of using remsh (or rsh for the OSF/1 operating system) instead of 
rlogin is that the the local system starts only one process (the client) with a 
remote shell; with the remote login, the local system starts both the remote 
login and the client. 

Starting Clients Remotely 

The following syntax starts a remote shell on a remote host, redirects remsh 
input, starts a client, and directs output to the local display. 

remsh remote -n client -display local: display . screen ft 
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remote The remote host name. 

client Absolute path of the executable client file (remsh does not 

allow the PATH variable). 

local Local host name. 

For example, the following command runs xload on remote host hpthere and 
directs output to the display of system hpxhere. 

remsh hpthere -n /usr/bin/Xll/xload -display hpxhere: 0.0 ft 

Generally, remsh is preferred to rlogin for starting a remote program from a 
menu. For example, the following line added to the workspace menu starts a 
remote hpterm window on remote host hpthere: 

"Doc files" f .exec "remsh hpthere -n /usr /bin/Ill /hpterm -display hpxhere: 0.0 t" 

Starting a Remote Non-Client 

At the command-line prompt of an existing window, you could execute: 

hpterm -display hpxhere: 0.0 -e remsh hpthere -n 11 & 

This example starts a new hpterm client and directs its output to the local 
display (-display hpxhere). The -e option executes a remote shell on 
hpthere that connects the window to the remote host hpthere and lists the 
files in your home directory there. When the 11 command finishes executing, 
the window created for it to run in will disappear. Thus, this method of 
starting remote non-clients is usually not desirable. 



Stopping Programs 

If a program has data you want to save, you must save the data before you stop 
it. 

If a terminal window is running a non-client containing data, you must stop the 
non-client in the approved manner before you stop the window. Generally, a 
non-client has a "stop" provision, or stops when it has finished executing. 
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After you have saved any data and exited any non-clients (in the case of 
terminal windows), stop the client by choosing the "Close" selection from the 
client's window menu. 

Note that if you started a non-client as an option of creating a window, when 
you stop the non- client, the window will stop. 

If you are unable to stop a program in the normal manner, you should "kill" 
the program before you log out. 

To kill a program, first try these keystrokes: 

■ Press [CTRL] Q. 

■ Press (ctrlI Q- 

■ Press Q. 

■ Press ( ESC 1 , then Q, then Q- 

If these don't work, use the HP-UX kill command to stop the program's 
execution environment or "process." To use the kill command: 

1. Save any data that needs saving. 

2. Find the PID (process ID) by executing: 

ps -fu login-name 

3. To kill the program, execute: 

kill -2 pid 
where pid is the PID number. This is equivalent to [ctrlI Q. 

4. If this doesn't work, execute: 

kill -3 pid 

5. If this still doesn't work, execute: 

kill -9 



Certain programs are cached during a session; that is, once they are started, 
closing them unmaps the window but does not stop the process. If you need to 
halt one of these processes during a session, use the kill command. 
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The X Clients 

The following tables list the X clients. 

Table 8-1. initialization and Configuration Clients. 



1 

Client 


Description 


Operating 
System 


Covered in 
Chapter . . . 


xmodmap 


Alters the modifier-key mappings 
of a keyboard. 


HP-UX 

Domain/OS 
OSF/1 


9 


xset 


Adjusts display preference 
options for a session. 


HP-UX 

Domain/OS 

OSF/1 


8 


xinitcolormap 


Initializes a new colormap for an 
X environment. 


HP-UX 

Domain/OS 

OSF/1 


8 


rgb 


Creates a color database for X. 


HP-UX 

Domain/OS 

OSF/1 


8 


xhost 


Adds a new remote host to your 
system. 


HP-UX 

Domain/OS 

OSF/1 


8 


xrdb 


Loads a window manager's 
resource configuration into the 
server. 


HP-UX 

Domain/OS 

OSF/1 


5 


xinit 


Starts the X server and clients. 


HP-UX 

Domain/OS 

OSF/1 


4 


xllstsirt 


Starts the XI 1 Window System 
using xinit. 


HP-UX 

Domain/OS 

OSF/1 


4 


dintox 


Switches between the Display 
Manager and X 


Domain/ OS 


4 
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Table 8-2. Window Management Clients. 



Client 


Description 


Operating 
System 


Covered in 
Chapter . . . 


resize 


Sets the environment to reflect 
the correct window size. 


HP-UX 
Domain/ OS 
OSF/1 


8 


xrefresh 


Repaints the display. 


HP-UX 

Domain/OS 


8 


xw in info 


Displays information about 
windows. 


HP-UX 

Domain/OS 

OSF/1 


8 
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Table 8-3. Graphics Functions Clients. 



Client 


Description 


Operating 
System 


Covered in 
Chapter . . . 


xseethru 


Opens a window into a graphics 
workstation image plane when 
the X Window System is running 
in the overlay planes. 


HP-UX 
OSF/1 


11 


xwd 


Makes a pixmap screen dump in 
xwd format. 


HP-UX 

Domain/OS 
OSF/1 


10 


xvd2sb 


Translates an xwd pixmap to 
Starbase format. 


HP-UX 

Domain/OS 
OSF/1 


11 


sb2xwd 


Translates a Starbase pixmap to 
xwd format. 


HP-UX 
OSF/1 


11 


xpr 


Prints a screen dump. 


HP-UX 

Domain/OS 

OSF/1 


10 


gvind 


Creates a window for Startbase 
applications. 


HP-UX 


11 


gwindstop 


Stops multiple Starbase X 
windows. 


HP-UX 
OSF/1 


11 


xvcreate 


Creates a new X window for 
Starbase. 


HP-UX 
OSF/1 


11 


xwdestroy 


Destroys a Starbase X window. 


HP-UX 

OSF/1 


11 


xwud 


Displays a previously made 
screen dump. 


HP-UX 

Domain/ OS 
OSF/1 


10 
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Table 8-4. Cut and Paste Clients 



Client 


Description 


Operating 
System 


Covered in 
Chapter . . . 


xclipboard 


Provides intermediate storage 
areas for cutting/pasting text 
between clients. 


HP-UX 

Domain/OS 

OSF/1 


8 


X cuts el 


Transfers information between 
selections and cut buffers 


HP-UX 

Domain/OS 

OSF/1 


8 


Table 8-5. Viewable Services Clients. 


CUent 


Description 


Operating 
System 


Covered in 
Chapter . . . 


xterm 


Terminal emulator for a DEC or 
Tektronix terminal. 


HP-UX 

Domain/OS 

OSF/1 


8 


hpterm 


Terminal emulator for TermO 
terminals. 


HP-UX 
OSF/1 


8 


xclock 


Displays an analog or digital 
clock. 


HP-UX 

Domain/OS 

OSF/1 


8 


xload 


Displays the system load average. 


HP-UX 

Domain/OS 

OSF/1 


8 


bitmap 


Creates bitmap files. 


HP-UX 

Domain/OS 
OSF/1 


8 


xsetroot 


Sets the color and appearance of 
the root window. 


HP-UX 

Domain/OS 

OSF/1 


8 
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Table 8-6. Font Management Clients 



Client 


Description 


Operating 
System 


Covered in 
Chapter . . . 


bdftosnf 


Compiles a BDF-formatted font 
into an X server format. 


HP-UX 

Domain/OS 

OSF/1 


6 


mkfontdir 


Creates a fonts.dir file. 


HP-UX 

Domain/ OS 
OSF/1 


6 


xfd 


Displays the characters of a 
particular X font. 


HP-UX 

Domain/OS 
OSF/1 


6 


xlsfonts 


Lists the fonts that match a 
given pattern. 


HP-UX 
OSF/1 


6 



The following clients do not require X to be running: rgb, xpr, xwd2sb, 
sb2xwd, and mkfontdir. 



Terminal Emulation Clients 

The X Window System has two terminal emulation clients. The default for 
HP-UX is hpterm. The default for OSF/1 and Domain/OS systems is xterm. 
hpterm is optional on OSF/1. 

The 'hpterm' Client 

The hpterm client emulates a TermO terminal. 
The syntax of the hpterm client is as follows: 

hpterm [ -options] [ & ] 

There are too many options to cover here. Refer to the hpterm man page for 
all the options available. 
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The 'xterm' Client 

The xterm client emulates DEC VT102 and Tektronix 4014 terminals. 
The syntax of the xterm client is as follows: 

xterm [-oph'ons] [&] 

There are too many options to cover here. Refer to the xterm man page for all 
the options available. 



The ^xclock' Client 

The xclock client displays an analog or digital clock. The digital clock also 
displays the day, date, time, and year; the format automatically varies for local 
language custom based on the value of the LANG environment variable. 



>o:iock 



□ 



Sun Jan 20 15:21:13 1991 



-xcid ' 


Jf 






■■■'-...,...*• 


rr„ 



Figure 8-1. Digital and Analog Clocks 

The syntax for the xclock client is: 

xclock [-opiz'ons] [ft ] 
For a complete list of xclock options, refer to the xclock man page. 
The following example creates a digital clock that updates every 10 seconds. 

xclock -digital -update 10 ft 

The next example creates an analog clock that chimes every 30 minutes, 
updates every 5 seconds, and has yellow hands (all the other colors are the 
default ones). 

xclock -analog -chime -update 5 -hd yellow ft 
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The 'xioad' Client 

The xload client displays a periodically updated histogram of the system load. 




Figure 8-2. The 'xload' Client 

The syntax for the xload client is: 

xload [-options] 

where: 

-hi color The color of the scale lines. 

- jumpscroll number The number of pixels to shift the graph to the left when 

the graph reaches the right edge of the window. The 
default is half the width of the current window. 



-label string 
-nolabel 
scale integer 

update seconds 



The string to put into the label above the histogram. 

No label is displayed above the histogram. 

The number of tic marks in the histogram. The default 
is 1. 

The frequency at which the histogram is updated. 



xload also accepts the toolkit command line options. 
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Creating Bitmaps with 'bitmap' 

The bitmap client creates bitmap files. 
The syntax for bitmap is: 

-help 

-display host: display, screen 

-geometry wxhd:col±row 

-nodashed 

-bw number 

-f n font 

-f g color 

-bg color 

-bd color 

-hi color 

-ms color 

-name name 



bitmap 



filename Widthx Height 
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-help Prints a summary of the command usage. 

-display Specifies the display where bitmap is to appear. 

-geometry Sets the size and location of the window. 

-nodashed Specifies the bitmap grid should use solid lines. 

-bw Specifies the border width of the main window in pixels. 

-fn Specifies the font to use in the bitmap command panel labels. 

-f g Specifies the foreground color. 

-bg Specifies the background color. 

-bl Specifies the color to be used for the window border. 

-hi Specifies the color of the highlight used to mark the center of a 

circle (the hot spot) and move areas. 

-ms Specifies the pointer color. 

-name Specifies a variable name to use when writing to a bitmap file. 

filename Specifies the name of the bitmap file to open or create. 

Widthx Height The size of the bitmap. Width and height are measured in 
pixels with one pixel equal to one cell on the bitmap grid. 

The bitmap client displays a variable-size grid, a command panel, and two 
preview bitmaps. You operate bitmap by using mouse buttons to draw pixels 
in the grid, one pixel per cell. The preview bitmaps display the bitmap in 
regular and reverse video. 
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eitiwp Editor 






Figure 8-3. The 'bitmap' Window. 
Table 8-7. How to Use the 'bitmap' Grid. 



If you want to . . , 


Do this . . . 


Draw a pixel. Change a cell from background to 
foreground color. 


Click button 1 on the cell. 


Invert a pixel color. Change a background- colored cell to 
foreground or a foreground colored cell to background. 


Click button 2 on the cell. 


Clear a pixel. Change a cell to the background color. 


Click button 3 on the cell. 
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The following table describes the bitmap command panel. 

Table 8-8. How to Use the 'bitmap' Command Panel. 



Task 


Control 


Set (clear) all cells to the background color. 


Clear All 


Set all cells to the foreground color. 


Set All 


Invert color of all cells. 


Invert All 


Set (clear) an area of the grid to the background color. 


Clear Area. 


Set an area of the grid to the foreground color. 


Set Area. 


Invert color of all cells in an area. 


Invert Area 


Copy one area of the grid to another. 


Copy Area 


Move an area of the grid to another position. 


Move Area 


Place one area of the grid over another. 


Overlay Area 


Draw a line between two points. 


Line 


Draw a circle with a given center and radius. 


Circle 


Draw a filled (foreground colored) circle with a given center 
and radius. 


Filled Circle 


Fill an enclosed (bounded) area. The area must be 
completely enclosed. 


Flood Fill 


Set a "hot spot" to mark the location of the cursor on a 
cursor bitmap. 


Set Hot Spot 


Ercise a "hot spot" from a cursor bitmap. 


Clear Hot Spot 


Save the bitmap to the file specified on the bitmap command 
line. 


Write Output 


Exit the bitmap client. 


Quit 



Creating a custom cursor (pointer) requires you to make a cursor bitmap and 
a cursor mask bitmap. The mask provides a background for the cursor and 
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prevents the pixels over which the cursor moves from showing through the 
cursor bitmap. 

For example, the following illustration shows both bitmaps for a space shuttle 
cursor. 
































































i 


yw^jB 







































Figure 8-4. Bitmaps for a Custom Cursor. 

Note the hotspot at the tip of the shuttle's nose. A hotspot is the single pixel 
that has been designated as the "point" of the pointer. 

You employ your custom cursor and mask bitmaps using the xsetroot client. 



Customizing the Root Window with 'xsetroot' 

The xsetroot client lets you: 

■ Customize the appearance of the root window. 

■ Change the bitmap used for the root window cursor. 
The xsetroot client has the syntax: 
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xsetroot 



-help 

-def 

-cursor path/ cursor path/mask 

-bitmap path/bitmap 

-mod X y 

-gray 

-f g color 

-bg color 

-TV 

-solid color 
_ -display hostidisplay. screen 



-help Prints a summary of the command usage. 

-def Resets unspecified root window attributes to their default 

values. 

-cursor Specifies the cursor bitmap and mask bitmap to use for the 

root window cursor. 

-bitmap Specifies a bitmap file with which to tile the root window. 

-mod Specifies a modular grid of dimensions a; by y in the foreground 

color, making a plaid pattern. 

-gray Specifies gray (or grey) for the color of the root window. 

-f g Specifies color as the foreground color. 

-bg Specifies color as the background color. 

-rv Swaps foreground and background colors. 

-solid Specifies the root window should be colored a solid color. 

-display Specifies the host, display number, and screen number of the 

root window to change. 

For example, the following command changes the workspace cursor using two 
custom bitmaps located in directory $HOME/bits. 

xsetroot -cursor '/bits/shuttle. bm " /bits /mask. bm 
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Changing Display Preferences with 'xset' 

The xset client allows you to change certain user preference options of the 
display. Note that hardware limitations and implementation differences may 
affect the results of the xset client. 

xset provides a way to set: 

■ Bell volume, pitch, and duration. 

■ Keyboard click volume and autorepeat. 

■ Mouse acceleration and threshold. 

■ Font paths. 

■ Screen saver time. 
The syntax for xset is: 



8-20 Using the X Clients 



xset 



-b 

on 
b^ off 

^ volume [ y pitch t [ ydumtion] ] 
-c 

'on 
c< off 

. [0-m] J 

-fp path[ ,path...] 
fp- path[ ,path...] 
+fp path[ ,path...] 
fp+ path[ ypath...] 
( default 1 

\path[ .path.,.] J 
f p= path 
f p rehash 

acceleration threshold 1 
default J 

p pixel color 
default 1 
" number \ 
-r 
'' on 
off 
' length period ' 
blank 
nobleink 
expose 
noexpose 
default 
on 
off 

-display host: display. screen 



{ 

i 

[ 

r 



s < 
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-b 



Turns the bell ofF. 



b on/off Turns the bell on or off. 

b v[p[d]] Specifies the bell volume, pitch, and duration. Volume is a. 

percentage between and 100 and can be specified without 
specifying pitch and duration. Pitch is in hertz and is specified 
together with a volume. Duration is in milliseconds and is 
specified with both volume and pitch. If only one parameter is 
given, it is taken as the volume. If two parameters are given, 
they are taken as volume and pitch. 

-c Turns the key click off. 

c on/off Turns the key click on or off. 

c 0-100 Specifies the key click volume as a percentage between and 

100. 

-f p/f p- Removes the specified directories from the font path. 

+f p/f p+ Prefixes or appends the specified directories to the font path 

(depending on the position of the +). 

fp default Restores the default font path. 

f p path Specifies the font path, absolutely. 

fp= path Sets the font path. 

fp rehash Causes the server to reread the fonts. dir file and the 

fonts .alias files in each path of the server's font path. 

m acceleration Specifies the acceleration and threshold of the mouse. 

threshold Acceleration indicates the change in mouse speed (for example: 

2=double, 3=triple). Threshold indicates the number of pixels 
of movement required before acceleration takes place. If only 
one number is given, it is taken as the acceleration. 

m default Resets the mouse acceleration and threshold to their default 
values. 

p pixel color Controls color on a per pixel basis. Pixel is an integer 

representing a specific pixel in the X server's colormap. The 
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exact number of pixels in the colormap depends on your 
hardware. Color specifies the color that pixel should be. 

pm default Restores the default font button codes to the pointer map. 

pm number Specifies the button codes for pointer map entries. 

-r Turns autorepeat off. 

r on/off Turns autorepeat on or off 

s length Sets the screen saver option on. Length is the number of 

period seconds that the server must be inactive before the screen 

is blanked. Period is the number of seconds a particular 
background pattern will be displayed before changing it. 

s blank Specifies that the screen saver should blank the video, 

if permitted by your hardware, rather than display the 
background pattern. 

s noblank Specifies that the screen saver should display the background 

pattern rather than blank the video. 

s expose Specifies that the server should discard window contents. 

s noexpose Specifies that the server should not enable the screen saver 
unless it saves window contents. 

s default Sets the system to its default screen saver characteristics. 

s on/off Sets the screen saver feature on or off. 

q Displays the current settings. 

-display Specifies the host, display number, and screen to be reset with 

xset. 
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Creating a Custom Color Database with 'rgb' 

The rgb.txt file in your system directory is the default color data base for 
the X Window System. It contains all the named colors and the amount of 
red, green, and blue needed to make the color. The following lines are from 
rgb.txt. Note that the red, green, and blue values are given as the decimal 
equivalents of their hexadecimal values. 

Table 8-9. Some Lines from 'rgb.txt'. 



Red 


Green 


Blue 


Color Name 


47 


47 


100 


MidnightBlue 


35 


35 


117 


navy blue 


35 


35 


117 


NavyBlue 


35 


35 


117 


navy 


35 


35 


117 


Navy 


114 


159 


255 


sky blue 


114 


159 


255 


SkyBlue 



As the above lines illustrate, several lines are sometimes necessary to account 
for alternative spellings of the same color. 

Depending on your needs, you may want to make your own custom color 
database modeled after the rgb . txt file. 

Your custom color database must have a different name from rgb.txt. You 
can either copy rgb.txt and make your changes, or start with an entirely new 
file. In either case, the file entries are in the following format: 

redvalue greenvalue bluevalue name 

The fields are separated by either tabs or spaces. 

The rgb . txt file is the source file used by the rgb client to make two other 
files that are used by the server: rgb.dir and rgb.pag. If you run rgb without 
any parameters, it will use rgb.txt. If you want to use your custom database, 
use the following syntax: 
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rgb outfile <infile 

where infile is the name of your custom database, the text file you created. 
The rgb client will create outfile. dir and outfile. -p^g. 

To put your new color database into effect, you must add it to your .xllstart 
file. For example, if your new database is composed of the files 2britG.txt, 
2brite.dir, and 2brite.pag in the /user/ellen directory, type the following 
command line to start your X environment: 

.xllstart — -co /user/ellen/2brite 

The server assumes the color database is in the /usr/lib/Xll directory unless 
told otherwise. 
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Initializing the Colormap with 'xinitcolormap' 

The xinit colormap client initializes the X colormap. Specific X colormap 
entries (pixel values) are made to correspond to specified colors. An initialized 
colormap is required by applications that assume a predefined colormap (for 
example, many applications that use Starbase graphics). 

xinit colormap reads a colormap file to determine the allocation of colors in 
the X colormap. The name of the colormap file is determined by using (in the 
following order): 

1. The command line option [-f colormapfile]. 

2. .Colormap default value. 

3. The xcolormap file in your system directory. 

4. If no colormap file is not found, this default colormap specification is 
assumed — black (colormap entry 0), white, red yellow, green, cyan, blue, 
magenta (colormap entry 7). 

xinitcolormap should be the first client program run at the start of a session 
in order to assure that colormap entries have the color associations specified in 
the colormap file. 



Adding and Deleting Hosts with 'xhost' 

Using xhost, you can add or delete a remote host's permission to access the 
local display server. 

For example, the following command allows the remote host hpggggg to access 
your local display. 

xhost +hpggggg 
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Resetting Environment Variables with 'resize' 

This client is available on HP-UX and Domain/OS. 

The resize client resets three environment variables: TERM, LINES, and 
COLUMNS. This enables a shell to reflect the current size of its window. 

Don't confuse resize, the client, with f .resize the window manager function. 
The f .resize function changes the size of a window, but does not reset any 
environment variables. The resize client, on the other hand, does not change 
the size of a window, but it does reset the environment variables. Resetting the 
environment variables enables non-client programs to adjust their output to the 
window's new size. 

Use resize whenever you resize a terminal emulator window and want a 
non-client program running in that window to reflect the window's new 
size. The resize client is typically used as an argument to the HP-UX eval 
command. 

The syntax for resize is as follows: 

' -c 
-h 
resize < -s [ row co/] 
-u 



-c 
-h 

-s 

-u 

-X 



Resets the environment variables for csh shells. 

Uses Hewlett-Packard terminal escape sequences to determine 
new window size. 

Uses Sun escape sequences to determine new window size. New 
row and column sizes are specified with row and col. 

Resets the environment variables for sh and ksh shells. 

Uses VT102 escape sequences to determine new window size. 



To see what the current COLUMN and LINES settings are, type the following 
command: 



resize 



[Return) 
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After you have resized a window either by dragging the window frame or by 
choosing the "Size" selection from the window menu, you can reset the LINES, 
and COLUMN environment variables to reflect the new window size by issuing 
the following command: 

eval 'resize' ( Return ] 

If you find yourself typing the above command too often, you can make things 
a little easier on yourself. If you use csh, try using an alias. The following line 
in your .cshrc file enables you to run resize by typing xr. 

alias xr 'set noglob; eval 'resize*' 

If you use sh or ksh create an xr function like the following: 

xr() {eval 'resize';} 



Repainting the Screen with 'refresh' 

The xref resh client "repaints" the screen or a specified portion of the screen. 
It does this by mapping, then immediately unmapping, a window over the area 
to be repainted. This obscuring-unobscuring causes the area to be redrawn. 
Repainting a screen removes the "graphics litter" that occasionally disfigures a 
screen. 

The xref resh client performs a similar task to the f .refresh window 
manager function. However, the xref resh client, because of its options, is 
more versatile. 

You can use xref resh from the command line of any terminal window and, 
using the -display option, you can repaint any display. 
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The syntax for xref resh is as follows: 



xrefresh 



( -white 

-black 

-solid color 

-root 
V -none 

-geometry widthx heights columnik row 
-display hostidisplay. screen 



-white Uses a white window to map the screen. 

-black Uses a black window to map the screen. 

-solid Uses a color colored window to m^ap the screen. 

-root Uses the root window to map the screen. 

-none Uses a transparent window to map the screen (default). 

-geometry Repaints a widthx height region located at :£colnmn^row on 

the screen (dimensions are in pixels). 

-display Specifies the screen to refresh. 

The following example illustrates using xref resh from the command line to 
repaint the upper left quarter of the screen. 

xrefresh -white -geometry 800x400+1+1 
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Getting Window Information with 'xwininfo' 

The xwininf o client is a utility program that displays useful information about 
windows. 

The syntax for xwininf o is as follows: 

-help 
r -id id 
-name name 
-root 
-int 
-tree 
-stats 



xw in info 



{-metric 1 



•english J 
-bits 
-events 
-size 
-wm 
-all 
-display host: display. screen 



-help Prints a summary of the command usage. 

-id Specifies the target window by window id. 

-name Specifies the target window by name. 

-root Specifies the root window as the target. 

-int Displays window information, normally shown as hexadecimal, 

as decimal. 

-tree Displays ids and names of the root, parent, and child windows. 

-stats Displays window id, location, size, depth, and other 

information as hexadecimal. 

-metric Displays height, width, x and y information in millimeters. 
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-english Displays height, width, x and y information in inches, feet, 

yards. 

-bits Displays information about bit and storage attributes. 

-events Displays event masks of the target window. 

-size Displays sizing information about the target window. 

-wm Displays the window manager hints for the target window. 

-all Displays all available information about a window. 

-display Specifies the host, display, and screen to target. 

This example illustrates the result of issuing the following command: 

XWininfo -stats ( Return 1 

Once you issue the command, select a window as the target of your inquiry by 
moving the pointer into that window and clicking button 1. 

xwininfo ==> Window id: 0x200013 (hpaaaaa) 

==> Upper left X: 6 

==> Upper left Y: 6 

==> Width: 484 

==> Height: 316 

==> Depth: 8 

==> Border width: 4 

==> Window class: InputOutput 

==> Colormap: 0x80065 

==> Window Bit Gravity State: NorthWestGravity 

==> Window Window Gravity State: NorthWestGravity 

==> Window Backing Store State: NotUseful 

==> Window Save Under State: no 

==> Window Map State: IsViewable 

-=> Window Override Redirect State: no 

==> Corners: +6+6 -782+6 -782-694 +6-694 
-geometry =80x24+6+6 



Using the X Clients 8-31 



Transfering Information Between Clients 

The X Window System provides two different mechanisms for transferring 
information between clients. These mechanisms are used by various clients, 
such as hpterm, to provide what is commonly referred to as their "cut and 
paste" operations. 

■ xclipboard 

■ xcutsel 

The Buffers 

There are three kinds of buffers that are used in transferring information 
between clients: 

■ cutbuffers. 

There are 8 cutbuffers, numbered to 7. These buffers can contain only text. 

■ selections. 

There are 3 selections generally named PRIMARY, SECONDARY, 
CLIPBOARD, although any name can be used. These selection buffers 
can contain any type of selection including graphics. Programs can set the 
PRIMARY, SECONDARY, or CLIPBOARD property and write to those 
buffers. 

■ xclipboard buffers. 

These buffers are numbered sequentially, beginning with 1, and they are 
assigned or deleted as they are needed. 

When you select text from an hpterm window, the selected text goes into 
cutbuffer and the PRIMARY selection. When you paste text to an hpterm 
window, the text is first obtained from the PRIMARY selection. If the 
PRIMARY selections does not contain anything, then cutbuffer is used. 
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Note 

4 



Although this chapter used "buffer" and "copy" for the 
selections, these are terms to aid understanding. Actually 
the ownership of the selection atoms is changed, rather than 
buffers being copied. Refer to the Interclient Communication 
Conventions Manual or the xclipboard and xcutsel man 
pages if you need more specific information than is given here. 



Using the 'xclipboard' Client 

The xclipboard client is used to collect and display text selections that are 
sent to the CLIPBOARD selection by other clients or by hpterm cut and paste. 

When xclipboard receives information, it stores the information in an 
internal xclipboard buffer, which is then assigned a number, and displays 
the information in the xclipboard window if one is open. The next time 
information is sent to the CLIPBOARD selection, xclipboard places it in a 
new buffer with a new number. 






(Quit ) (Delete ) (New) (Save) (k^) (Pr&v) [T] 




Figure 8-5. The 'xclipboard' Client 
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The button across the top of the xclipboard window perform the functions 
listed below. If a function does not apply, the button is grayed out. 

Quit Leave the xclipboard client. 

Delete Empty the current buffer. 

New Create a new buffer and assign it the next consecutive number 

available. 

Save Save the current buffer in a file. 

Next Display the next buffer. 

Prev Display the previous buffer. 

number The number is the box shows the number of the buffer being 

displayed. 

The xclipboard client has the following syntax: 

xclipboard [ -opfzons ] [ -w ] [ -nw ] 

where: 

-options are the standard client options. 

-w indicates that the lines of text that are too long to be displayed 

on one line should wrap to the following line. 

-nw indicates that long lines of text should not wrap. This is 

the default behavior. If the text is too long for the window, 
indicators appear on the bottom and side of the window as 
shown in Figure 8-8. 
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Using the 'xcutsel' Client 

The xcutsel client is used to copy the information back and forth between 
the current cut buffer and the current selection. By default this is cutbuffer 
and the PRIMARY selection, but you can change this with command line 
arguments. 



xcutsel 



_J 



quit 



copy PRIMARY to O 



copy to PRIMARY 



± 



j_ 



Figure 8-6. The 'xcutsel' Client 

The xcutsel client has the following syntax: 

xcutsel [-oph'ons] [-selection selection^ [-cutbuffer number] 

where: 

-options are the standard client options. 

-selection specifies the name of the selection to be used. The default is 
PRIMARY. 

-cutbuffer specifies the cut buffer to be used. The default is 0. 

Example 1: Using Only 'xclipboard' 

This example shows how to copy text from an hpterm window into a file, using 
the xclipboard clients. (This uses the text widget copy capability). 

1. Start the xclipboard client. 

xclipboard & 

2. Display the text you want to copy in an hpterm window. 

3. Select some text from the hpterm window. 



Using the X Clients 8-35 



hpuifm 



This is a bunch of useless text that will not be copied anywhere. 

This is a bunch of useless text that will not be copied anjnfhere. 

This is a bunch of useless text that will not be copied anywhere. 

This text is much longer than the first line. This text is much longer 
than the first line. This text is much longer than the first line. 

This text is much longer than the first line. This text is much longer 
than the first line. 



Figure 8-7. Selected Text 

4. Paste this text into the xclipboard window. 

5. Select more text from the hpterm window. 

6. Move the xclipboard cursor to the position you want the new text placed 
in and paste the text into the window. 



u. 



Puit) (Pe le"te ) ^ev) (Sarve) ( H-sxt ) (pv7^ \T\ 



This is a short line of text. 

This text is much longer than the first 
than the first line. This text is much 
This text is much longer than the first 
than the first line. 



Figure 8-8. Text Copied to xclipboard 

7. Select the Save button on xclipboard. 

8. Press the Accept button. The file clipboard contains the text. 
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Example 2: Using 'xcutsel' and 'xclipboard' 

This does almost the same thing as sample 1 using both xclipboard and 
xcutsel but does not use the text widget copy functionality. 

1. Start the xclipboard client. 

xclipboard & 

2. Start the xcutsel client with the CLIPBOARD selection. 

xcutsel -selection CLIPBOARD & 



xcuttei I ■> i jj 



quit I 



copy CLIPBOARD to 



copy to CLIPBOARD 



'■ ■ - ---..- .t: 



Figure 8-9. The 'cutset' Window 

3. Display the text you want to copy in an hpterm window. The text you 
select goes to cutbufFer and the PRIMARY selection. 

4. Choose the "0 to CLIPBOARD" selection on the xcutsel window to copy 
the text to cutbufFer of the CLIPBOARD selection. 

The xclipboard window shows the new text and the number of the 
xclipboard buffer in which it resides. 

Each time you press the "0 to CLIPBOARD" button, the information in 
cutbuffer is placed in the next CLIPBOARD buffer, so you cannot collect 
several selections in one clipboard buffer as in the previous example. 

5. As in the previous example, press the Save button to create a file containing 
the text that was shown. 
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Customizing the IVIouse and Keyboard 

This chapter describes the following customizations: 

■ Changing mouse button actions. 

■ The xmodmap client. 

■ Going mouseless. 

■ Customizing keyboard input. 
Related information: 

■ Chapter 7 contains mwm mouse and keyboard bindings. 



Changing Mouse Button Actions 

Normally, the mouse pointer buttons are mapped as follows: 
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Table 9-1. Default Mouse Button Mapping. 



Button 
Number 


Button on a 2-button 
mouse 


Button on a 3-button Mouse 


Button 1 


Left button 


Left button 


Button 2 


Both buttons simultaneously 


Middle button 


Button 3 


Right button 


Right button 


Button 4 




Left and middle buttons 
simultaneously 


Button 5 




Middle and right buttons 
simultaneously 



However, you can change these mappings. To generate buttons 4 and 5 on a 
three-button mouse, you must enable button chording as described later in this 
chapter. 

Table 9-2. Alternative Mouse Button Mappings. 



To press 
Button 


Left Hand Mapping 


OSF/Motif Mapping 


2-button mouse 


3-button mouse 


2-button mouse 


3-button mouse 


Button 1 


Right button 


Right button 


Left button 


Left button 


Button 2 


Both buttons 
simultaneously 


Middle button 


Right button 


Middle button 


Button 3 


Left button 


Left button 


Both buttons 
simultaneously 


Right button 


Button 4 




Middle and 
right buttons 
simultaneously 




Left and middle 

buttons 

simultaneously 


Button 5 




Middle and left 

buttons 

simultaneously 




Right and 
middle buttons 
simultaneously 
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The xmodmap utility can be used to change mouse button mappings. The 
syntax for changing mouse button mappings with xmodmap is: 

.. r pointer = default 1 .. ' 

xmodmap pointer = number [ number...] 



-e 



-pp 



Specifies a remapping expression. Valid expressions are covered 
in "Customizing Keyboard Input" later in this chapter. 



default Set mouse keys back to default bindings 

number Specifies a list of button numbers to map the mouse keys 

to. The order of the numbers refers to the original button 
mapping. 

pp Print the current pointer mapping. 

For example, to reverse the positions of buttons 1 and 3 for left-handed 
mapping: 

xmodmap -e "pointer = 321" 2-button mouse 

xmodmap -e "pointer = 32154" 3-button mouse 

To establish OSF/Motif-standard button mapping: 

xmodmap -e "pointer =13 2" 2-button mouse 

xmodmap -e "pointer =13 2 4 5" 3-button mouse 
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Going Mouseless with the 'X^pointerkeys' File 

Your work situation may lack sufficient desk space to adequately use a mouse 
pointer. You may, therefore, want to "go mouseless" by naming the keyboard 
(or some other input device) as the pointer. 

To go mouseless, you need to have the proper configuration specified in the 
X*devicGS file and to have a special configuration file named X+pointerkeys. 
The default X*pointGrkeys file is XOpointerkeys in the system directory. In 
light of your experience with XOscreens and XOdevices, you will probably 
recognize this as no mere coincidence. 

The X*pointerkeys file lets you specify: 

■ The keys that move the pointer. 

■ The keys that act as pointer buttons. 

■ The increments for movement of the pointer. 

■ The key sequence that resets Xll. 

■ The pixel threshold that must be exceeded before the server switches pixel 
planes in stacked screen mode. 

■ That button cording is enabled or disabled. 

■ Tablet scaling. 

If you modify a X*pointGrkGys file, it does not take effect until you restart the 
X Window System again. 

Configuring *X*devices' for Mouseless Operation 

If you have only one keyboard and no pointer devices on the HP-HIL, and 
you want the keyboard to serve as both keyboard and pointer, you don't have 
to change the default configuration of XOdevices. The default input device 
configuration automatically assigns the pointer to the keyboard if a pointer 
can't be opened by the server. 

If you have two or more input devices, you may need to explicitly specify which 
device should be the keyboard and which the pointer. 
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The Default Values for the 'X*pointerkeys' File 

By default, when you configure your keyboard as the pointer, the X server 
chooses certain number pad keys and assigns them mouse operations. Some 
number pad keys are assigned to pointer movement; other number pad keys are 
assigned to button operations. 

If you don't need to change the pointer keys from their default specifications, 
you don't need to do anything else to use your keyboard as both keyboard 
and pointer. However, if you need to change the default pointer keys, you 
must edit the XOpointerkeys file or create a new X*pointerkeys file. The 
X*pointGrkeys file is the file that specifies which kevs are used to move the 
pointer when you use the keyboard as the pointer. 

The default key assignments are listed in the tables in the following section on 
customizing the X*pointerkeys file. 

Creating a Custom 'X*pointerkeys' File 

You need to modify the existing XOpointerkeys file only if the following 
statements are true: 

■ You want to use the keyboard for a pointer. 

■ You want to change the pointerkeys from their default configuration. 

■ You use the XOscreens file to configure your display. 

You need to create a custom X+pointerkeys file only if the following 
statements are true: 

■ You want to use the keyboard for a pointer. 

■ You want to change the pointerkeys from their default configuration. 

■ You use a configuration file other than the XOscreens file to configure your 
display. 

Syntax 

You assign a keyboard key to a mouse function (pointer movement or 
button operation) by inserting a line in the X*pointerkeys file. Lines in the 
X*pointerkeys file have the syntax: 
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function keyname [# comment] 

Assigning Mouse Functions to Keyboard Keys 

You can assign any mouse function, either a pointer movement or a button 
operation, to any keyboard key. However, make sure that the key you are 
assigning doesn't already serve a vital function. 

You can assign keyboard keys to pointer directions by specifying options in an 
X*pointGrkGys file. The following table lists the pointer movement options, 
the X*pointerkeys functions that control them, and their default values: 

Table 9-3. Pointer IMovement Functions. 



Movement Option 


Function 


Default Key 


Move the pointer to the left. 


point er_left_key 


keypad- 1 


Move the pointer to the right. 


point er_right_key 


keypad_3 


Move the pointer up. 


point er_up_key 


keypad_5 


Move the pointer down. 


point er_down_key 


keypad_2 


Add a modifier key to the 


pointer_key_modl 


no default 


pointer direction keys. 






Add a second modifier key to 


point er_key_mod2 


no default 


the pointer direction keys. 






Add a third modifier key to the 


po int er_k ey _niod3 


no default 


pointer direction keys. 







Note that the pointer direction keys are the keypad number keys on the right 
side of the keyboard, not the keyboard number keys above the text character 
keys. 
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You can assign keyboard keys to pointer distances by specifying options in a 
XOpointerkeys file. The following table lists the options that determine the 
distance of pointer movements, the X*pointGrkeys functions that control 
them, and their default value: 

Table 9-4. Pointer Distance Functions. 



Movement 


Function 


Default 


Move the pointer a number of 


pointer _move 


10 pixels 


pixels. 






Move the pointer using a 


point er_modl_amt 


40 pixels 


modifier key. 






Move the pointer using a 


po int er _mod2_aint 


1 pixel 


modifier key. 






Move the pointer using a 


po int er _inod3_anit 


5 pixels 


modifier key. 






Add a modifier to the distance 


point er_aint_niodl 


no default 


keys. 






Add a modifier to the distance 


po int er_anit _mod2 


no default 


keys. 






Add a modifier to the distance 


pointer_amt_mod3 


no default 


keys. 
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You can assign keyboard keys to mouse button operations by specifying options 
in a X*pointerkeys file. The following table lists the button operations, the 
X*pointerkeys functions that control them, and their default values: 

Table 9-5. Button Operation Functions. 



Button Operation 


Function 


Default Key 


Perform button 1 operations. 
Perform button 2 operations. 
Perform button 3 operations. 
Perform button 4 operations. 
Perform button 5 operations. 


point er_buttonl_key 
po inter _button2_key 
po int er _but t on3_key 
po int er _but t on4_key 
point er_button5_key 


keypad-* 
keypad-/ 
keypad-+ 
keypad-- 
keypad-7 



You can change the mapping of buttons on the pointer by using options in the 
X*pointerkeys file. The following table lists the X+pointerkeys functions 
that control button mapping and their default values. Like xmodmap and xset, 
these functions aflFect only the X pointer, not any extension input devices. 



Table 9-6. Button Mapping Functions. 


Button Mapping 


Function 


Default Key 


Set button 1 value 


button_l_value 


1 


Set button 2 value 


butt on_2_ value 


2 


Set button 3 value 


butt on_3_ value 


3 


Set button 4 value 


button_4_ value 


4 


Set button 5 value 


button_5_value 


5 



You can change the key sequence that exits the X Window System. Also, if 
you use both image and overlay planes, you can change the distance you must 
move the pointer before you switch planes. The following table lists these 
options, the X*pointGrkeys functions that control them, and their default 
values: 
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Table 9-7. Reset and Threshold Functions. 



Option 


Function 


Default Key 


Exit the X Window System 


reset 


break 


Add a modifier to the exit key. 


reset _modl 


control 


Add a modifier to the exit key. 


reset_mod2 


left_shift 


Add a modifier to the exit key. 


reset.modS 


no default 


Set the threshold for changing 


s or een_change_aint 


30 pixels 


between screens. 






These keys are used together to 


borrow_mode_key 


F9 


switch from Xdomain to the 


borrow_mode_modl_key 


left_shift 


Display Manager in the 


borrow_mode_mod2_key 


control 


Domain/OS only 







screen. change.amt is used only if your system is configured for more than 
one screen. (Refer to "Using Custom Screen Configurations" in Chapter 3). 
screen.change.amt enables you to avoid switching from one set of pixel 
planes to another if you accidentally run the pointer off the edge of the screen, 
screen. change. amt establishes a "distance threshold" that the pointer must 
exceed before the server switches pixel planes. As the previous table shows, the 
default width of the threshold is 30 pixels, but acceptable values range from 
to 255. 

When a graphics tablet is used as the X pointer, the screen.change.amt 
defines an area at the left and right edges of the tablet surface that will be used 
to controU screen changes. Moving the puck or stylus into the left or right area 
will cause the X server to switch to the previous or next screen. 

Table 9-8. Button Chording 



Option 


Function 


Default 


Turn button chording oflJ" or on. 


button. chording 


ON for devices with 2 buttons, 
OFF for devices with >2 
buttons. 
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Button chording refers to the generation of a button by pressing two other 
buttons. If you have a two-button mouse, you can generate button 3 by 
pressing both buttons together. With a three-button mouse, you can generate 
button 4 by pressing the left and middle buttons together and button 5 by 
pressing the middle and right buttons together. 

Table 9-9. Specifying a Portion of a Tablet 



Option 


Function 


Default 


Use a subset of the tablet 


tablet_width 


disabled 


surface as the X pointer device 


tablet_height 

tablet_xorigin 

tablet_yorigin 





If a tablet is used as the X pointer device, it may be desirable to use only 
a portion of the tablet surface. A rectangular subset of the surface may be 
specified with these functions. The units are in millimeters from the upper left 
corner of the tablet surface. For example, if you want to use only an "A" size 
portion of a larger "B" size tablet, the following lines could be added to the 
X*pointerkeys file: 

tablGt.subset^xorigin 68 

tablGt_subset_yorigin 40 

tablet.subsGt.width 296 

tablet_subset_height 216 

Modifier Keys 

You can select up to three keys from among the two (shift) keys, the two 
[Extend char) keys, and the (CTRL) key and use them each as modifier keys. A 
modifier key is a key that, when you hold it down and press another key, 
changes the meaning of that other key. 

Modifier keys in the X*pointerkeys file have three functions: 

■ They specify that a certain operation can't take place until they are pressed. 
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They enable you to adjust the distance covered by the pointer during a 
movement operation. 

They enable you to change the key sequence that exits you from XI 1. 
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For example, you can overcome the problem in the last example by assigning 
the (Left Shift) key as a modifier to the pointer direction keys. Now, to move the 
hpterm cursor to the right, you press Q as usual. To move the x server pointer 
to the right, you press [left Shift) (T) . 

Specifying Pointer Keys 

The following table lists the valid keynames to use when assigning keyboard 
keys to mouse functions: 
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Table 9-10. Valid Pointer Keynames for HP 46021A Keyboards. 


Typewriter Keys: 










1 A 


K 


U 


left-shift 


return 


2 B 


L 


V 


left-extend 


> 


3 C 


M 


W 


- 


. 


4 D 


N 


X 


= 


/ 


5 E 





Y 


backspace 


right-shift 


6 F 


P 


Z 


[ 


space_bar 


7 G 


Q 


( 


] 


right-extend 


8 H 


R 


tab 


\ 




9 I 


S 


caps-lock 


J 




J 


T 


control 


) 




Function Keys: 










fl f3 


f5 


f7 


blank_f9 


blank-fll 


f2 f4 


m 


f8 


blank-flO 


blank-fl2 


Keypad Keys: 










keypad- 1 keypad_4 


keypad_7 


keypad_0 


keypad-+ 


keypad-comma 


keypad_2 keypad_5 


keypad_8 


keypad-* 


keypad-- 


keypad-tab 


keypad_3 keypad_6 


keypad- 9 


keypad-/ 


keyp ad -enter 


keypad-period 


Special Keys: 










enter stop 


clear-line 


delete -line 


home-cursor 


cursor-up 


escape menu 


clear- display 


insert- char 


prev 


next 


break system 


insert-line 


delete -char 


select 


cursor-left 


cursor_down cursor_right 











Examples 

If you only have one keyboard and no mouse, and you can live with the default 
pointer key assignations, you don't have to do anything else to configure your 
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system for mouseless operation. To move the pointer to the left 10 pixels, you 
would press the (T) key on the keypad. To press mouse button 1 you would 
press the Q key on the keypad. 

However, suppose you wanted to move only one pixel to the left. Although 
the default value of pointer_mod2_amt is one pixel, no key is assigned to the 
modifier for that amount. Thus, you would need to edit the XOpointerkeys file 
(or create an X*pointerkeys) to include a line assigning one of the modifier 
keys to po inter _amt_mod2. The following line in XOpointerkeys assigns the 
[Left Shift) key to po inter _amt_mod2: 

###point erf unction key 

po inter _amt_mod2 left.shift 

Or suppose you wanted to set up your XOpointerkeys file so that you could 
move 1, 10, 25, and 100 pixels. The following lines show one way to specify 
this: 

###pointer function key 

pointer_amt_modl left^extend 

pointer_amt_mod2 left^shift 

po inter _amt_mod3 control 

pointer.move l.pixels 

pointer_modl_amt 10_pixels 

pointer_mod2_amt 25_pixels 

pointer_mod3_amt lOO^pixels 

With these lines in effect, one press of the Q key on the keypad moves the 
pointer 1 pixel to the left. Pressing the left [Extend char) and (T) moves the 
pointer 10 pixels to the left. Pressing [Left Shift) (T) moves the pointer 25 pixels 
to the left. And pressing [CTRL) Q moves the pointer 100 pixels to the left. 
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Or, take the case previously mentioned where you want to use the arrow keys 
for both text cursor and mouse pointer. You could insert the following lines in 
your XOpointGrkeys file: 

###pointer function key 

pointGr_kGy_modl left_shift 

pointGr_lGft_kGy cursor_lGft 

pointGr_right_kGy cursor.right 

point Gr_up_key cursor.up 

pointGr_down_kGy cursor.down 

The above lines enable you to use the arrow keys for cursor movement, 
while using the shifted arrow keys for pointer movement. Note that only the 
[Left Shift] key (and not the (Right Shift) ) modifies the press of an arrow key from 
cursor to pointer movement. 

Now, suppose you want to use the arrow keys to operate the pointer, and 
you also need the arrow keys to control the cursor in an hptGrm window. 
Furthermore, another application uses the shift-arrow key sequence to control 
its cursor. 

The easiest way to solve this dilemma is to call in another modifier. The 
following lines illustrate this. Compare them to the previous example. 

###pointer function key 

point6r_key_modl left^shift 

pointer_k6y_mod2 iGft.Gxtond 

pointGr_left_key cursor_lGft 

point Gr_right_key cursor.right 

pointGr.up.key cursor_up 

pointGr_down_kGy cursor.down 

In this example, 

■ Pressing the Q key moves the hpterm text cursor up. 

■ Pressing (left Shift) (X) moves the cursor up in the program you frequently 
operate. 

■ Pressing (Left Shift) (Left Extend char) fT) moves the pointer up. 

Using a similar technique, you can also reassign the (ctrl) (Left Shift) (Reset) 
sequence that aborts a session. You can specify the press of a single key or a 
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combination of two, three, or four key presses. Just make sure that the key 
sequence you select isn't something you're going to type by accident. 



Customizing Keyboard Input 

Besides remapping the mouse's pointer and buttons to your keyboard, you can 
remap any key on the keyboard to any other key. 



Modifying Modifier Key Bindings with 'xmodmap' 

To change the meaning of a particular key for a particular Xll session, or to 
initialize the X server with a completely different set of key mappings, use the 
xmodmap client. 



Note 



There are now two keyboards available for Hewlett-Packard 
workstations, the 46021A keyboard, and the C1429A keyboard. 
See appendix B, Using the Keyboards, for more information on 
using these keyboards and the differences between them. 



The syntax for xmodmap is as follows: 

-help 
-grammar 
-e expression 

{-verbose 1 
-quiet J 
-n 

-P 
-pm 

-pk 

-PP 

-display hostidisplay 



xmodmap 



\^ filename]^ 



-display Specifies the host, display number, and screen to use. 

9-16 Customizing the Mouse and Keyboard 



-help Displays a brief description of xmodmap options. 

-grammar Displays a brief description of the syntax for modification 

expressions. 

-verbose Prints log information as xmodmap executes. 

-quiet Turns off verbose logging. This is the default. 

-n Lists changes to key mappings without actually making those 

changes. 

-e Specifies a remapping expression to be executed. 

-pm, -p Prints the current modifier map to the standard output. This 

is the default. 

-pk Prints the current keymap table to the standard output. 

-pp Print the current pointer map to the standard output. 

Specifies that the standard input should be used for the input 
file. 

filename Specifies a particular key mapping file to be used. 
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Specifying Key Remapping Expressions 

Whether you remap a single key "on the fly" with a command-line entry or 
install an entire new keyboard map file, you must use valid expressions in your 
specification, one expression for each remapping. 

A valid expression is any one of the following: 

Table 9-11. Valid 'xmodmap' Expressions. 



To do this . . . 


Use this expression . . . 


Assign a key symbol to a keycode. 


keycode keycode = keysym 


Replace a key symbol expression with another. 


keysym keysym = keysym 


Clear all keys associated with a modifier key. 


clear modifier 


Add a key symbol to a modifier. 


add modifier = keysym 


Remove a key symbol from a modifier. 


remove modifier = keysym 



keycode Refers to the numerical value that uniquely identifies each 

key on a keyboard. Values may be in decimal, octal, or 
hexadecimal. 

keysym Refers to the character symbol name associated with a 

keycode, for example, KP_Add. 

modifier Specifies one of the eight modifier names. 

The following are the modifier names available for use in keyboard 
customization: 



Table 9-12. Valid Modifier Names. 



Modifier Names 



Shift Control Mod2 Mod4 
Lock Modi Mods Mod5 
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On Hewlett-Packard HP-UX keyboards, the modi modifier is set to the 
(Extend char) keys (Meta_L and Meta_R). However, any of the modifiers can be 
associated with any valid key symbol. Additionally, you can associate more 
than one key symbol with a modifier (such as Lock = Shift_R and Shift_L), 
and you can associate more than one modifier with a key symbol (for example, 
Control = Meta_L and Modi = Meta_L). 

For example, you can press (d) to print a lower case "d", (shift) (d) to print a 

capital "D", (Extend char) Q to print something else, and (shift) (Extend char) Q to 

print still something else. 

The xmodmap client gives you the power to change the meaning of any key at 
any time or to install a whole new key map for your keyboard. 

Examples 

Suppose you frequently press the (Caps) key at the most inopportune moments. 
You could remove the (Caps) lock key from the lock modifier, swap it for the (n) 
key, then map the (n) key to the lock modifier. Do this is by creating a little 
swapper file that contains the following lines: 

!This file swaps the [Caps] key with the [Fl] key. 

remove Lock = Caps^Lock 
keysym Caps.Lock = Fl 
keysym Fl = Caps.Lock 
add Lock = Caps.Lock 

Note the use of the ! in the file to start a comment line. To put your 
"swapper" file into effect, enter the following on the command line: 

xmodmap swapper 

If you use such a swapper file, you should probably have an unswapper file. 
The following file enables you to swap back to the original keyboard mapping 
without having to exit Xll: 
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!This file unswaps the [Fl] key with the [Caps] key. 

remove Lock - Caps.Lock 
keycode 88 = Fl 
keycode 55 = Caps_Lock 
add Lock = Caps .Lock 

Note the use of the hexadecimal values to reinitialize the keycodes to the 
proper key symbols. You put your "unswapper" file into effect by entering the 
following command line: 

xmodmap imswapper 

On a larger scale, you can change your current keyboard to a Dvorak keyboard 
by creating a file with the appropriate keyboard mappings. 

xmodmap . kejrmap 

Printing a Key Map 

The -pk option prints a list of the key mappings for the current keyboard. 

xmodmap -pk 

The list contains the keycode and up to four 2-part columns. The first column 
contains unmodified key values, the second column contains shifted key values, 
the third column contains meta ( (Extend charl ) key values, and the fourth column 
contains shifted meta key values. Each column is in two parts: hexadecimal 
key symbol value, and key symbol name. 
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Printing and Screen Dumps 



The X Window System includes clients that enable you to do screen dumps. A 
screen dump is an operation that captures an image from your screen and saves 
it in a bitmap file. You can then redisplay, edit, or send the file to the printer 
for hardcopy reproduction. 

Read this chapter if you need to "take a picture" of something on the screen 
for future use or if you want to print what is on your screen. 

This chapter discusses the following topics: 

■ Making a screen dump. 

■ Displaying a screen dump. 

■ Printing a screen dump. 
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Making and Displaying Screen Dumps 

XI 1 windows can be dumped into files by using the xwd client. The files can be 
redisplayed on the screen by using the xwud client. 



Making a Screen Dump with 'xwd' 

The xwd client allows you to take a "picture" of a window that is displayed on 
the screen and store it in a file. The filed picture can then be printed, edited, 
or redisplayed. You select the window to be dumped either by clicking the 
mouse on it or by specifying the window name or id on the command line. 

The resulting file is called an xwd-format bitmap file or an xwd screen dump. 
All of the figures used in this manual are xwd screen dumps. 

The syntax for xwd is as follows: 

-help 
r -id id 

-name name 

-root 
-add value 
-nobdrs 
J > filename 
\ -out filename 
-xy 
-display display 



xwd 



-help Provides a brief description of usage and syntax. 

-id Specifies the window to be dumped by its id rather than using 

the mouse to select it. 

-add Adds value to every pixel. 

-name Specifies the window to be dumped by its name rather than 

using the mouse to select it. 

-root Specifes that the window to be dumped is the root window. 

-nobdrs Dumps the window without borders. 
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-out Specifies that the screen dump is to be stored in the file 

filename. 

> Specified that the screen dump is to be stored in the file 

filename. 

-xy Selects 'XY' format of storage instead of the default 'Z' format. 

-display Specifies the screen that contains the window to be dumped. 

This first example stores a window in a file named savewindow, using the 
pointer to determine which window you want. 

1. Display the an hpterm or xterm window. 

2. Type: 

XWd -out savewindow [Return] 

The pointer changes shape, signifying you can select a window to dump. 

3. Move the pointer into the window you want to dump. Press and release any 
pointer button. After the image is captured, the cursor changes back to its 
normal shape and the window is stored in the file savewindow. 

If you know the name of the window you want to dump, you don't need to use 
the pointer at all. This example dumps the window named "calendar" to a file 
named calendar. d\imp. 

xwd -name calendar -out calendar. dump [Return) 

Displaying a Stored Screen Dump with 'xwud' 

The xwud client allows you to display an xwd-format file on your monitor. You 
could have created the file earlier with xwd or translated it from another format 
into xwd format. 

Note The image to be restored has to match the depth of the display 

I on which it is to be restored. For example, an image created 

Mi and stored using a depth of four cannot be restored on a 

display with a different depth. 
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The syntax for xwud is as follows: 



xvud 



-help 

-in filename 
-inverse 
.-display host: display. screen 



-help Displays a brief description of the options, 

-in Specifies the file containing the screen dump, 

-inverse Reverses black and white from the original monochrome dump, 

-display Specifies the screen on which to display the dump. 

This example displays the xwd-format file myf ile. 
xwud -in myf ile ( Return ) 
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Printing Screen Dumps 

Before you can print the screen dump, you need to ensure that your printer is 
connected and talking to your computer. 

Refer to the system administrator manual(s) for your system if you need to: 

■ Connect the printer to your computer, 

■ Create a device file for the printer on your computer. 

■ Run the print spooler. 



xpr 



Printing Screen Dumps with ^xpr' 

xpr prints a screen dump that has been produced by xwd. 

-scale scale 
-density dpi 
-height inches 
-width width 
-left inches 
-top inches 
-header caption 
-trailer caption 

{-landscape "I 
-portrait J filename 

-TV 

-compact 

J -output filename 

\ -append filename 

-noff 

-split n 

-device dev 

-cutoff level 

-noposition 



) 



-scale 



Specifies a multiplier for pixel expansion. The default is the 
largest that will allow the entire image to fit on the page. 
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-density Specifies the dots per inch for the printer. 

-height Specifies the maximum height in inches of the window on the 

page. 

-width Specifies the maximum width in inches of the window on the 

page. 

-left Specifies the left margin in inches. The default is centered. 

-top Specifies the top margin in inches. The default is centered. 

-header Specifies a caption to print above the window. 

-trailer Specifies a caption to print below the window. 

-leuidscape Prints the window in landscape mode. The default prints the 
long side of the window on the long side of the paper. 

-portrait Prints the window in portrait mode. The default prints the 

long side of the window on the long side of the paper. 

-rv Reverses black and white from the original screen. 

-compact Provides efficient printer directions for a window with lots of 

white space (PostScript printers only). 

-output Specifies a file to store the output in. 

-append Adds the window to the end of an existing file. 

-nof f Specifies that the window should appear on the same page as 

the previous window. Used with -append. 

-split Prints the window on n pages. Not applicable to HP printers. 

-device Specifies the printer to use. 



Ijet 


HP LaserJet series, HP Think Jet, HP 




QuietJet, RuggedWriter, HP2560 series, 




HP2930 series, other PCL devices. 


pjet 


HP PaintJet (color mode). 


pjetxl 


HP PaintJet XL. 


ln03 


DEC LN03. 


lalOO 


DEC LAIOO. 


ps 


PostScript printers. 


PP 


IBM PP3812. 
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-cutoff Specifies intensity for converting color to monochrome for 

printing on a HP LaserJet printer. 

-noposition Bypasses header positioning, trailer positioning, and image 
positioning commands for the HP LaserJet and HP PaintJet 
printers. 

filename Specifies the xwd file to print. 

For example, suppose you want to print a xwd file named myf ile that you 
previously created with xwd . You want to print the file on a HP LaserJet 
printer in portrait mode with black and white the reverse of the original xwd 
file. 

xpr -device Ijet -portrait -rv myf ile I Ip -oraw f Return 1 

Reversing colors is often used when preparing illustrations for documents. The 
original illustration can be done in white with a black background, which is 
easy to see on computer displays, but reversed to give a black drawing on a 
white background, which is common in printed material. 

Moving and Resizing the Image on the Paper 

You may not always want to have the image print exactly in the same size or 
location as the default choices place it. 

Sizing Options 

The three sizing options for xpr are: 

-scale Each bit of the image is translated into a grid of the size you 

specify. For example, if you specify a scale of 5, each bit in the 
image is translated into a 5 by 5 grid. This is an easy way to 
increase the size without refiguring the height and width. 

-height The maximum height in inches of the image on the page. 

-width The maximum width in inches of the image on the page. 

The actual printed size could be smaller than -height and -width if other 
options, such as the orientation ones, conflict with them. 
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Location Options 

The two location options for xpr are: 

-left The left margin in inches. 

-top The top margin in inches. 

If -left is not specified, the image is centered left-to-right. If -top is not 
specified, the image is centered top-to-bottom. 

Orientation Options 

The two orientation options to xpr are: 

-landscape The image is printed so that the top of the image is on the 
long side of the paper. 

-portrait The image is printed so that the top of the image is on the 

short side of the paper. 

If neither option is specified, xpr will position the image so that the long side 
of the image is on the long side of the paper. However, you can force it to print 
either in landscape mode or portrait mode by using the appropriate option. 

Unless told otherwise by the sizing options, xpr makes the image as big as 
necessary to fit in the orientation specified. 

Printing Multiple images on One Page 

xpr normally prints each image on a separate page. The -nof f option is used 
to print more than one image on a page. 

Printing Color Images 

Use the device name p j et to direct output to a HP PaintJet printer. 

For example, the following command prints a xwd file named myf ile on a HP 
PaintJet printer. 

xpr -device pjet myf ile (Return) 

Color images printed on a HP LaserJet printer will be in black and white 
instead of color. 
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xpr prints only in black and white, no shades of gray. If your original color 
image contained many colors of the same intensity, the HP LaserJet printer 
version may be all light or all dark. If that happens, use the -cutoff option 
to change the mapping of color intensities. Anything above the cutoff value 
is white and anything below is black. Note that the default cutoff value is 50 
percent. 

If you want color images to print in shades of gray on your Laserjet, use the 
StarBase utility pcltrans instead of xpr. Refer to the StarBase documentation 
for information. 
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Using Starbase 



Note Starbase runs on the HP-UX and OSF/1 operating systems. 



4 



Starbase is a powerful graphics library from Hewlett-Packard, It provides 
two-dimensional and three-dimensional graphics, a variety of input and output 
capabilities, and high performance features, such as hidden surface removal, 
shading, and light sourcing. 

This chapter describes how the X Window System interacts with Starbase. 
It does not describe Starbase itself. For detailed information about 
Starbase features, refer to Starbase Programming with XI 1 in the Starbase 
documentation. 

This chapter covers the following topics: 

■ Setting environment variables for Starbase. 

■ Using the X*screens file to control display options. 

■ Starting the X server. 

■ Opening and destroying windows for Starbase applications. 

■ Creating transparent windows. 

■ Conversion utilities. 
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11 Using the X^screens File 

This section reviews some concepts that you need to understand before starting 
Starbase applications: 

■ X*screens Ale. 

■ Operating modes. 

■ Double buffering. 

The X*screens file is a system file that contains the screen configurations you 
want to use. Before you run a Starbase application, you should ensure that the 
configuration is correct for Starbase. The X*screens file is described in chapter 
3. 

The following sections describe options you should be aware of when running 
Starbase with the X Window System. It also explains how to specify those 
options in the X*scrGens file. 
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Operating Modes 

A table later in this section describes which options and modes are possible on 
specific hardware. 

Image and Overlay Planes 

Display hardware can have two kinds of display planes, image and overlay. The 
image plane allows the hardware to help the graphics commands run faster and 
more efficiently. 

Server Operating Modes 

The operating mode results from the way you specify the image and overlay 
screens in the X* sere ens file. 

The four different modes are: 

Overlay mode The server operates only in the overlay planes. Starbase can 

display in its "raw" mode, writing directly to the image planes, 
rather than to a window. A "transparent" overlay window 
can look through to the Starbase display in the image planes. 
Starbase can use the double buffering feature only in the image 
planes, not the overlay planes. 

Image mode This is the only mode available on those displays that do not 
have overlay planes. Even if overlay planes are available, you 
may want to use image mode to have a greater number of 
colors available. 

Stacked screen In this mode, the image planes are treated as one screen and 
mode the overlay planes as another, separate screen, providing twice 

as much screen space. The pointer is moved to the edge of the 
display to switch between the overlay and image planes. 

Combined This mode, when available, treats the overlay and image planes 

mode as a single device that provides multiple window types to client 

programs. 

Monochrome and LOW_COLOR displays run in the image mode. 

Documentation for the Starbase application program will tell you which mode 
or which plane the application expects. 
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^^ Double Buffering 

Double buffering means that Starbase uses half of the color planes of your 
displays to display to the screen, and uses the other half to compute and draw 
the next screen display. This provides smooth motion for animation, and it is 
also faster. However, double buffering reduces the number of colors available 
for displaying on the screen at one time. Some applications require double 
buffering. If you run a double-buffered application in singlebuffer mode, the 
display will flash or flicker rapidly. 

This feature does not apply to monochrome displays or when the X server is 
running in the overlay planes. 

The following example shows an X*screens file with appropriate entries for 
image, stacked, and combined screen modes, while enabling double buffer mode 
in the image planes: 

### Image Mode ### 

/dev/ image-device doublebuffer 

### Stacked Screens Mode ### 

# /dQv/ overlay -device 

# /dQ-v/ image-device doublebuffer 

### Combined Screens Mode ### 

# /dev/ overlay-device /dev/ image-device doublebuffer 
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Screen Depth ^^ 

You can specify a screen depth for image planes in the X* screens file. 
Valid depths for regular (single buffer) mode are 8 and 24. Valid depths 
for doublebuffered mode are 8, 16, and 24. The depth of overlay planes is 
determined by the /dev entry in X*screens. 

More planes means more colors can be displayed simultaneously. For 
computer-generated graphics to look as realistic as photographs, thousands of 
colors must be shown at the same time. 8 planes means that 2* (256) colors 
can be shown, while 24 planes means that 2^^ (16 million) colors can be shown. 
Note that depth is specified only when you have more than one depth available. 

The following example shows an X* screens file entry for a display running in 
image mode. Windows can have 8 planes (256 colors) displayed simultaneously. 

/ dev / image-device depth 8 

The next following example provides two doublebuffered depths in the image 
planes: depth 8 (16 planes/2) and depth 12 (24 planes/2). That is, some 
windows in the image planes could have a depth of 8 planes, while others could 
have a depth of 12 planes. This is possible only in combined mode. 

/ dev / overlay-device /dev /image-device depth 16 depth 24 doublebuffer 
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Display Hardware Options 

Table 11-1. Display Hardware and Available Options 



With this display 
hardware . . . 


You can use these options . . . 


HP Part Number 


Maximum Planes (colors) 


Modes 


Double 
buffer 


Depth 


HP A1096 


1 Image (monochrome) 


Image 






HP A1416 


2 Overlay (4) 
8 Image (256) 


Image 

Overlay 

Stacked 


^/ 




HP A1439 


8-24 Image (256) 


Image 






HP A1659 


8 Image (256) 


Image 






HP A1924 


8 Image (256) 


Image 






HP 9000S300 
Model 425e 


8 Image (256) 


Image 


7 




HP 9000S700 
Model 710 


8 Image (256) 


Image 






HP 98542A 


1 Image (monochrome) 


Image 






HP 98543A 


4 Image (16) 


Image 


V 




HP 98544B 


1 Image (monochrome) 


Image 






HP 98545A 


4 Image (16) 


Image 






HP 98547A 


6 Image (64) 


Image 


V 




HP 98548A 


1 Image (monochrome) 


Image 






HP 98549A 


6 Image (64) 


Image 


v/ 




HP 98550A 


2 Overlay (4) 
8 Image (256) 


Image 

Overlay 

Stacked 


y 
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Table 11-1. Display Hardware and Available Options (continued) 



With this display 
hardware . . . 


You can use these options . . . 


HP Part Number 


Maximum Planes (colors) 


Modes 


Double 
bujRer 


Depth 


HP 98704A 


3/4 Overlay 
8/16 Image 


Image 

Overlay 

Combined 


^/ 


V 


HP 98720A 


3 Overlay (8) 
8-24 Image (256) 


Image 

Overlay 

Stacked 




V 
V 


HP 98730A 


3/4 Overlay 
8-24 Image (256) 


Image 
Overlay 
Stacked 
Combined 






HP 98735A 


3/4 Overlay 
8-24 Image 


Image 

Overlay 

Combined 


V 


y 


HP 98765A 


3/4 Overlay 
8-24 Image 


Image 

Overlay 

Combined 


y 


V 
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starting the Server 

Once you have ensured that the options you need are in the X*screGns file, 
you must restart the server for the options to take effect. 
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11 Window-Smart and Window-Naive Programs 

Window- smart applications are able to create and destroy the windows in 
which they operate. 

Window-naive (sometimes called window-dumb) applications aren't able to 
create and destroy windows on their own. They need help from the X Window 
System. 

Is My Application Window-Smart or Window-Naive? 

If you are using an existing application, the documentation that comes with the 
application will tell you how to start it. You don't have to worry whether it is 
window-smart or window-naive, just follow the directions. 

If you are writing a new application using Starbase, use the xwcreate and 
xwdestroy commands. Rather than typing the commands each time you want 
to test the new program, put the commands in a file, then execute the file to 
start the application. In this case, the application is window-naive but the file 
is window-smart. 

Running Window-Smart Programs 

From an hpterm window, type the name of the Starbase program you want to 
run. 

For example, the following command will start a hypothetical Starbase 
application named planetarium that displays a moving view of the night 
sky. Assume that the program is in the /users /funs tuff directory on your 
computer. 

/users/fimstuff /planetarium [Return] 

Running Window-Naive Programs 

Window-naive programs cannot open and close the window they need to run 
in, so you must do it for them with clients (a terminal emulator, for example). 
Some old programs that use the Starbase graphics library are window-naive. 

Most window-naive programs are able to run in the X Window System 
environment using the soxll device driver. The soxll driver is described in 
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the Starbase Device Drivers manual. But window-naive clients still need help 

to create and destroy the windows they display their output in. "* "^ 

To enable window-naive graphics programs to run within X, you need four 
special helper clients to create and destroy the windows used by the naive 
graphics programs. The clients are: 

■ gwind (HP-UX only) 

■ xwcreate 

■ xwdestroy 

■ gwindstop (HP-UX only) 

On HP-UX operating systems, gwind runs in the background and services 
requests from the other three helper clients. When requested by xwcreate, 
gwind creates a window in which an application can display its output; when 
requested by xwdestroy, gwind destroys the window. You don't need to start 
the gwind program,, xwcreate and xwdestroy start and stop it for you. 

On OSF/1 operating systems, xwcreate and xwdestroy create and destroy 
windows directly, gwind and gwindstop are not available. The next sections 
cover: 

■ Creating a window 

■ Destroying a window 

Creating a Window with 'xwcreate' 

xwcreate requests gwind to create a window for a window-naive graphics 
program to use for its output. The graphics program must exist on the same 
computer that is running xwcreate. If gwind is not already running when 
xwcreate is executed, xwcreate will start gwind. Once xwcreate has created 
a window, you can use the window to run your graphics program. When you 
finish that application, you can use the same window to run another graphics 
program if you wish. 

Use xwcreate from the command line. 
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xwcreate 



-display host: display. screen 

-parent parent 

-geometry widthx heighti: col± row 

-r 

-bg color 

-bw pixels 

-bd color 

-depth depth 

-visual visualclass 

-overlay 

-wmdir directory 

-title name 



-display Specifies the screen the window will appear on 

-parent Names a window to be the parent of the window being created. 

-geometry Specifies desired size and location of window. 

-r Specifies backing store. Default is no backing store. 

-bg Specifies the background color. The default is black. 

-bw Specifies the border width in pixels. The default is 3 pixels 

wide. 

-bd Specifies the border color. The default is white. 

-depth Specifies the depth of the window. The default is the same 

depth as its parent. 

-visual Specifies the visual class of the window when multiple visual 

classes are supported by the display at the specified depth. 

-overlay Specifies that an overlay plane visual should be used. 

-wmdir Specifies the name of the directory containing the pty file for 

the window. 

-title Specifies the name the window will be called. 

The depth option is where you tell the window manager what set of planes you 
want the window to be in. If you specify nothing, the window is created with 
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the same depth as its parent, or with the same depth as the root if no parent is 
specified. If you specify a depth, the window will be placed in the image plane "^"^ 

with the depth (number of color planes) you specify. 

The following example creates a window named "foo:" 

xwcreate -title foo [ Return ) 

Destroying a Window with 'xwdestroy' 

xwdestroy destroys the window created by xwcreate. If that window is the 
only graphics window present at that time, gwind will also terminate. 

Use xwdestroy from the command line. 

xwdestroy ["vrndir path/directory] window 1 window2 ... 

-wmdir Specifies the directory containing the pty file for the window. 

window Specifies the window or windows to be destroyed. 

The following example will destroy a window named "foo:" 
xwdestroy foo 
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Destroying a Window with ^gwindstop' 

gwindstop is used on HP-UX systems only. 

gwindstop destroys all windows created by gwind in the specified directory. If, 
however, you use xwdestroy to remove the last window opened for graphics 
use, xwdestroy will terminate gwind. You do not need to use gwindstop. 

Caution You must use xwdestroy or gwindstop to get rid of a window 

• after you have finished running your graphics application. Do 

not use kill to remove the gwind process associated with 
the window. If you should accidentally do so, you must type 
the command rm $WMDIR/wm. Failure to do this will result in 
xw ere ate not running the next time you call it. 

Use gwindstop from the command line. 

gwindstop idirectory] [.directory] . . . 

directory The directory containing the pty files for the windows to be 

destroyed. 



Running Starbase in Raw Mode 

If your display supports overlay planes, you can run Starbase in "raw" mode, 
which means that Starbase writes to the entire screen rather than to a window. 
You then use a transparent window to see through to the Starbase output. 

For information about Starbase raw mode, refer to the Starbase 
documentation. 
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Using Transparent Windows n 

Transparent windows allow you to look through an overlay window into the 
image planes. 

Creating a Transparent Window with 'xseethru' 

xseethru is a transparent overlay-plane window used to see through the 
overlay planes to the image planes. 



Use xseethru from the command line, 
xseethru 



-geometry widthx height± col± row 
-display host .'display, screen 



-geometry The geometry used to create the window. 

-display The screen the window will appear on. 

This example opens a transparent window 100-pixels by 100-pixels in size and 
located 50 pixels from the left and 25 pixels from the top of the screen. 



xseethru -geometry 100x100+50+25 (Return) 

Creating a Transparent Window with 'xsetroot' 

xsetroot allows you to make the root window transparent when you are 
running X in the overlay planes. 

Use xsetroot from the command line. 

xsetroot [-solid color] 
-solid Sets the window color to color. 

This example turns the root window into a transparent window. 

xsetroot -solid transparent [Return] 
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^1 Creating a Transparent Background Color 

Any window may have transparent as its background color. 
This example opens an hpterm window with a transparent background color, 
hpterm -bg transparent [Return) 



Conversion Utilities 

This section shows you how to use the utilities sb2xwd and xwd2sb . 

Converting Starbase Format to 'xwd' Format using 'sb2xwd' 

sb2xwd converts Starbase format window files into xwd format pixmaps. The 
pixmaps can then be printed by using xpr or displayed on the screen by using 
xwud, both of which are described in chapter 8. 

Use sb2xwd from the command line. 

The syntax for sb2xwd is: 

sb2xwd < filename > filename 

Kfilename The Starbase window file to be converted. 

> filename The xwd pixmap file name. 

This example translates the Starbase window file named my star into an xwd 
pixmap file named myxwd, then prints it on an HP LaserJet printer. 

sb2xwd < my star > myxwd 

xpr -dev Ijet myxwd I Ip -craw 

Converting 'xwd' Format to Starbase Format using 'xwd2sb' 

xwd2sb is the opposite of sb2xwd. It converts xwd format pixmaps into 
Starbase format window files. 

Use xwd2sb from the command line. 

The syntax for xwd2sb is: 
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xwd2sb < filename >filename 

11 
<filename The xwd bitmap file to be converted. 

> filename The Starbase window file filename. 

This example dumps a window named sample into a xwd file called myxwd, 
translates it into a Starbase window file called my star, and prints it using the 
Starbase pcltrans utility. 

xwd -name sample -out myxwd 
xwd2sb < myxwd > my star 
pcltrans mystar | Ip -craw 
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Reference Information 



This section contains reference information (man pages) for the X server, 
clients, and utility programs included with the X Window System. The entries 
are arranged alphabetically, each starting on its own "page 1." 



Table A-1. Man Pages 



bdftosnf(l) 


xfd(l) 


bitmap(l) 


xhost(l) 


gwind(l) 


xinit(l) 


gwindstop(l) 


xinit colormap ( 1 ) 


hpterm 


xload(l) 


mkfontdir(l) 


xlsfonts(l) 


mwm(l) 


xmodmap(l) 


resize(l) 


xpr(l) 


rgb(l) 


xrdb(l) 


sb2xwd(l) 


xrefresh(l) 


stconv(l) 


xseethru(l) 


stlicense(l) 


Xserver(l) 


stload(l) 


xset(l) 


stmkdirs(l) 


xsetroot(l) 


stinkfont(l) 


xterm(l) 


X(l) 


xwcreate(l) 


xllstart(l) 


xwd(l) 


xclipboard(l)) 


xwd2sb(l) 


xclock(l) 


xwdestroy(l) 


xcutsel(l) 


xwininfo(l) 


xdm(l) 


xwud(l) 


Xdoniain(l) 
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NAME 

bdftosnf - BDF to SNF font compiler for Xll 

SYNOPSIS 

bdftosnf [-p#] [-u#] [-m] [-1] [-M] [-L] [-w] [-W] [-t] [-i] [bdf-file] 

DESCRIPTION 

bdftosnf reads a Bitmap Distribution Format (BDF) font from the specified file (or from standard 
input if no file is specified) and writes an Xll server normal font (SNF) to standard output. 

OPTIONS 

-p# Force the glyph padding to a specific number. The legal values are 1, 2, 4, and 8. 

-u# Force the scanline unit padding to a specific number. The legal values are 1, 2, and 4. 

-m Force the bit order to most significant bit first. 

-1 Force the bit order to least significant bit first. 

-M Force the byte order to most significant byte first. 

-L Force the byte order to least significant bytef irst. 

■w Print warnings if the character bitmaps have bits set to one outside of their defined 

widths. 

-W Print warnings for characters with an encoding of -1; the default is to silently ignore such 

characters. 

-t Expand glyphs in "terminal-emulator" fonts to fill the bounding box. 

-i Don't compute correct ink metrics for "terminal-emulator" fonts. 

SEE ALSO 

X(l), Xserver(l) 

"Bitmap Distribution Format 2.1" 
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NAME 

bitmap, bmtoa, atobm - bitmap editor and converter utilities for X 

SYNOPSIS 

bitmap [-options ...] filename WIDTHxHEJGHT 

bmtoa [-chars ...] {filename] 

atobm [-chars cc] [-name variable] [-xhot number] [-yhot number] [filename] 

DESCRIPTION 

The bitmap program is a rudimentary tool for creating or editing rectangular images made up of 
I's and O's. Bitmaps are used in X for defining clipping regions, cursor shapes, icon shapes, and 
tile and stipple patterns. 

The bmtoa and atobm filters convert bitmap files (FILE FORMAT) to and from ASCII strings. 
They are most commonly used to quickly print out bitmaps and to generate versions for including 
in text. 

USAGE 

Bitmap displays grid in which each square represents a single bit in the picture being edited. 
Squares can be set, cleared, or inverted directly with the buttons on the pointer and a menu of 
higher level operations such as draw line and fill circle is provided to the side of the grid. Actual 
size versions of the bitmap as it would appear normally and inverted appear below the menu. 

If the bitmap is to be used for defining a cursor, one of the squares in the images may be desig- 
nated as the hotspot. This determines where the cursor is actually pointing. For cursors with 
sharp tips (such as arrows or fingers), this is usually at the end of the tip; for symmetric cursors 
(such as crosses or buUseyes), this is usually at the center. 

Bitmaps are stored as small C code fragments suitable for including in applications. They provide 
an array of bits as well as symbolic constants giving the width, height, and hotspot (if specified) 
that may be used in creating cursors, icons, and tiles. 

The WIDTHxHEIGHT argument gives the size to use when creating a new bitmap (the default is 
16x16). Existing bitmaps are always edited at their current size. 

If the bitmap window is resized by the window manager, the size of the squares in the grid will 
shrink or enlarge to fit. 

OPTIONS 

Bitmap accepts the following options: 

-help 

This option will cause a brief description of the allowable options and parameters to be 
printed. 

-display display 

This option specifies the name of the X server to used. 

-geometry geometry 

This option specifies the placement and size of the bitmap window on the screen. See X for 
details. 

-nodashed 

This option indicates that the grid lines in the work area should not be drawn using dashed 
lines. Although dashed lines are prettier than solid lines, on some servers they are 
significantly slower. 

-name variablename 

This option specifies the variable name to be used when writing out the bitmap file. The 
default is to use the basename of the filename command line argument. 

-bw number 

This option specifies the border width in pixels of the main window. 
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-tnfont 

This option specifies the font to be used in the buttons. 

■^ color 

This option specifies the color to be used for the foreground. 

-bg color 

This option specifies the color to be used for the background. 

-hi color 

This option specifies the color to be used for highlighting. 

-bd color 

This option specifies the color to be used for the window border. 

-ms color 

This option specifies the color to be used for the pointer (mouse). 

Bmtoa accepts the following option: 

-chars cc 

This option specifies the pair of characters to use in the string version of the bitmap. The 
first character is used for bits and the second character is used for 1 bits. The default is to 
use dashes (-) for O's and sharp signs (#) for I's. 

Atobm accepts the following options: 

•chars cc 

This option specifies the pair of characters to use when converting string bitmaps into arrays 
of numbers. The first character represents a bit and the second character represents a 1 bit. 
The default is to use dashes (-) for O's and sharp signs (#) for I's. 

-name variable 

This option specifies the variable name to be used when writing out the bitmap file. The 
default is to use the basename of the filename command line argument or leave it blank if the 
standard input is read. 

-xhot number 

This option specifies the X coordinate of the hotspot. Only positive values are allowed. By 
default, no hotspot information is included. 

-yhot number 

This option specifies the Y coordinate of the hotspot. Only positive values are allowed. By 
default, no hotspot information is included. 

CHANGING GRID SQUARES 

Grid squares may be set, cleared, or inverted by pointing to them and clicking one of the buttons 
indicated below. Multiple squares can be changed at once by holding the button down and drag- 
ging the cursor across them. Set squares are filled and represent I's in the bitmap; clear squares 
are empty and represent O's. 

Button 1 

This button (usually leftmost on the pointer) is used to set one or more squares. 
The corresponding bit or bits in the bitmap are turned on (set to 1) and the square 
or squares are filled. 

Button 2 

This button (usually in the middle) is used to invert one or more squares. The 
corresponding bit or bits in the bitmap are flipped (I's become O's and O's become 
I's). 

Button 3 

This button (usually on the right) is used to clear one or more squares. The 
corresponding bit or bits in the bitmap are turned off (set to 0) and the square or 
squares are emptied. 

MENU COMMANDS 

To make defining shapes easier, bitmap provides 13 commands for drawing whole sections of the 
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grid at once, 2 commands for manipulating the hotspot, and 2 commands for updating the bitmap 
file and exiting. A command button for each of these operations is located to the right of the grid. 

Several of the commands operate on rectangular portions of the grid. These areas are selected 
after the command button is pressed by moving the cursor to the upper left square of the desired 
area, pressing a pointer button, dragging the cursor to the lower right hand comer (with the but- 
ton still pressed) , and then releasing the button. The command may be aborted by pressing any 
other button while dragging or by releasing outside the grid. 

To invoke a command, move the pointer over that command and click any button. 

ClearAll 

This command is used to clear all of the bits in the bitmap as if Button 3 had been 
dragged through every square in the grid. It cannot be undone. 

Set All 

This command is used to set all of the bits in the bitmap as if Button 1 had been 
dragged through every square in the grid. It cannot be undone. 

Invert All 

This command is used to invert all of the bits in the bitmap as if Button 2 had been 
dragged through every square in the grid. 

ClearArea 

This command is used to clear a region of the grid as if Button 3 had been dragged 
through each of the squares in the region. When this command is invoked, the 
cursor will change shape to indicate that the area to be cleared should be selected 
as outlined above. 

Set Area 

This command is used to set a region of the grid as if Button 1 had been dragged 
through each of the squares in the region. When this command is invoked, the 
cursor will change shape to indicate that the area to be set should be selected as 
outlined above. 

Invert Area 

This command is used to inverted a region of the grid as if Button 2 had been 
dragged through each of the squares in the region. When this command is 
invoked, the cursor will change shape to indicate that the area to be inverted 
should be selected as outlined above. 

Copy Area 

This command is used to copy a region of the grid from one location to another. 
When this command is invoked, the cursor will change shape to indicate that the 
area to be copied should be selected as outlined above. The cursor should then be 
clicked on the square to which the upper left hand comer of the region should be 
copied. 

Move Area 

This command is used to move a region of the grid from one location to another. 
When this command is invoked, the cursor will change shape to indicate that the 
area to be moved should be selected as outlined above. The cursor should then be 
clicked on the square to which the upper left hand comer of the region should be 
moved. Any squares in the region's old position that aren't also in the new posi- 
tion are cleared. 

Overlay Area 

lliis command is used to copy all of the set squares in a region of the grid from 
one location to another. When this command is invoked, the cursor will change 
shape to indicate that the area to be copied should be selected as outlined above. 
The cursor should then be clicked on the square to which the upper left hand 
comer of the region should be overlaid. Only the squares that are set in the region 
will be touched in the new location. 
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Line 

This command will set the squares in a line between two points. When this com- 
mand is invoked, the cursor will change shape to indicate that the pointer should 
be clicked on the two end points of the line. 

Circle 

This command will set the squares on a circle specified by a center and a point on 
the curve. When this command is invoked, the cursor will change shape to indicate 
that the pointer should be clicked on the center of the circle and then over a point 
on the curve. Small circles may not look very round because of the size of the grid 
and the limits of having to work with discrete pixels. 

Filled Circle 

This command will set all of the squares in a circle specified by a center and a 
point on the curve. When this command is invoked, the cursor will change shape 
to indicate that the pointer should be clicked on the center of the circle and then 
over a point on the curve. All squares side and including the circle are set. 

Flood Fill 

This command will set all clear squares in an enclosed shape. When this com- 
mand is invoked, the cursor will change shape to indicate that the pointer should 
be clicked on any empty square inside the shape to be filled. All empty squares 
that border horizontally or vertically with the indicated square are set out to the 
enclosing shape. If the shape is not closed, the entire grid will be filled. 

Set Hot Spot 

This command designates one square in the grid as the hot spot if this bitmap to 
be used for defining a cursor. When the command is invoked, the cursor will 
change indicating that the pointer should be clicked on the square to contain the 
hot spot. 

Clear Hot Spot 

This command removes any designated hot spot from the bitmap. 

Write Output 

This command writes a small fragment of C code representing the bitmap to the 
filename specified on the command line. If the file already exists, the original file 
will be renamed to filename' before the new file is created. If an error occurs in 
either the renaming or the writing of the bitmap file, a dialog box will appear ask- 
ing whether or not bitmap should use /tmp/ filename instead. 

Quit 

This command causes bitmap to display a dialog box asking whether or not it 
should save the bitmap (if it has changed) and then exit. Answering ye^ is the same 
as invoking Write Output; no causes bitmap to simply exit; and cancel will abort the 
Quit command so that more changes may be made. 

FILE FORMAT 

The Write Output command stores bitmaps as simple C program fragments that can be compiled 
into programs, referred to by X Toolkit pixmap resources, manipulated by other programs (see 
xsetroot), or read in using utility routines in the various programming libraries. The width and 
height of the bitmap as well as the hotspot, if specified, are written as preprocessor symbols at the 
start of the file. The bitmap image is then written out as an array of characters: 

#define name_width 11 
# define name_height 5 
#define iiame_x_hot 5 
#define namejy_hot 2 

static char name_bits[] = { 
0x91, 0x04, Oxca, 0x06, 0x84, 
0x04, 0x8a, 0x04, 0x91, 0x04 
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}; 

The name prefix to the preprocessor symbols and to the bits array is constructed from the 
filename argument given on the command line. Any directories are stripped ofif the front of the 
name and any suffix beginning with a period is stripped off the end. Any remaining non- 
alphabetic characters are replaced with underscores. The namejcjtot and name_yjwt symbols 
will only be present if a hotspot has been designated using the Set Hot Spot command. 

Each character in the the array contains 8 bits from one row of the image (rows are padded out at 
the end to a multiple of 8 to make this is possible). Rows are written out from left to right and top 
to bottom. The first character of the array holds the leftmost 8 bits of top line, and the last char- 
acters holds the right most 8 bits (including padding) of the bottom line. Within each character, 
the leftmost bit in the bitmap is the least significant bit in the character. 

This process can be demonstrated visually by splitting a row into words containing 8 bits each, rev- 
ersing the bits in each word (since Arabic numbers have the significant digit on the right and 
images have the least significant bit on the left), and translating each word from binary to hexade- 
cimal. 

In the following example, the array of I's and O's on the left represents a bitmap containing 5 rows 
and 11 columns that spells XI 1. To its right is the same array split into 8 bit words with each row 
padded with O's so that it is a multiple of 8 in length (16): 

10001001001 10001001 00100000 

01010011011 01010011 01100000 

00100001001 00100001 00100000 

01010001001 01010001 00100000 

10001001001 10001001 00100000 

Reversing the bits in each word of the padded, split version of the bitmap yields the left hand 
figure below. Interpreting each word as a hexadecimal number yields the array of numbers on the 
right: 

10010001 00000100 0x91 0x04 

11001010 00000110 Oxca 0x06 

10000100 00000100 0x84 0x04 

10001010 00000100 0x8a 0x04 

10010001 00000100 0x91 0x04 

The character array can then be generated by reading each row from left to right, top to bottom: 

static char namebitsQ = { 
0x91, 0x04, Oxca, 0x06, 0x84, 
0x04, 0x8a, 0x04, 0x91, 0x04 

}; 

The bmtoa program may be used to convert bitmap files into arrays of characters for printing or 
including in text files. TTie atobm program can be used to convert strings back to bitmap format. 

USING BITMAPS IN PROGRAMS 

The format of bitmap files is designed to make bitmaps and cursors easy to use within X pro- 
grams. The following code could be used to create a cursor from bitmaps defined in this.cursor 
and this jnask.cursor. 

#include "this-cursor" 
#include "this_mask.cursor" 

XColor foreground, background; 

/* fill in foreground and background color structures */ 

Pixmap source = XCreateBitmapFromData (display, drawable, 
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this_bits, this_width, this_height); 
Pixmap mask = XCreateBitmapFromData (display, drawable, 

this_mask_bits, this_mask_width, this_mask_height); 
Cursor cursor = XCreatePixmapCursor (display, source, mask, 

foreground, background, this_x_hot, this_y_hot); 

Additional routines are available for reading in bitmap files and returning the data in the file, in 
Bitmap (single-plane Pixmap for use with routines that require stipples), or full depth Pixmaps 
(often used for window backgrounds and borders). Applications writers should be careful to 
understand the difference between Bitmaps and Pixmaps so that their programs function correctly 
on color and monochrome displays. 

For backward compatibility, bitmap will also accept XIO format bitmap files. However, when the 
file is written out again it will be in Xll format 

X DEFAULTS 

Bitmap uses the following resources: 

Background 

The window's background color. Bits which are in the bitmap are displayed in this color. 
This option is useful only on color displays. The default value is white. 

BorderColor 

The border color. This option is useful only on color displays. The default value is black. 

BorderWidth 

The border width. The default value is 2. 

BodyFont 

The text font. The default value is variable. 

Dashed 

If "off', then bitmap will draw the grid lines with solid lines. The default is "on". 

Foreground 

The foreground color. Bits which are 1 in the bitmap are displayed in this color. This option 
is useful only on color displays. The default value is black. 

Highlight 

The highlight color, bitmap uses this color to show the hot spot and to indicate rectangular 
areas that will be affected by the Move Area, Copy Area, Set Area, and Invert Area commands. 
If a highlight color is not given, then bitmap will highlight by inverting. This option is useful 
only on color displays. 

Mouse 

The pointer (mouse) cursor's color. This option is useful only on color displays. The default 
value is black. 

Geometry 

The size and location of the bitmap window. 

Dimensions 

The WIDTHxHEIGHT to use when creating a new bitmap. 

SEE ALSO 

X(l), Xlib - C Language X Interface (particularly the section on Manipulating Bitmaps), XmuRead- 
BitmapDataFromFile 

BUGS 

The old command line arguments aren't consistent with other X programs. 

If you move the pointer too fast while holding a pointer button down, some squares may be 
missed. This is caused by limitations in how frequently the X server can sample the pointer loca- 
tion. 

There is no way to write to a file other than the one specified on the command line. 
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There is no way to change the size of the bitmap once the program has started. 
There is no undo command. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See X{1) for a full statement of rights and permissions. 

AUTHOR 

bitmap by Ron Newman, MIT Project Athena; documentation, bmtoa, and atobm by Jim Fulton, 
MIT X Consortium. 
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NAME 

gwind - graphics window daemon 

SYNOPSIS 

gwind 

DESCRIPTION 

The gtvind program creates X windows under the command of the utility programs xwcreate, 
xwdestroy, and gtvindstop. The window can then be accessed by Starbase application program (see 
xwcreateQmy). The daemon remains in operation until all windows created via xwcreate are des- 
troyed, or until the gwindstop utility is executed. 

FILES 

/dev/screen directory created to contain the pty devices used to communicate 

between the utility programs and the gwind daemon. 

DEPENDENCIES 

Implemented on the Series 300 and 800 only. 

SEE ALSO 

gwindstop(lm), xwcreate(lm), xwdestroy(lm) 

AUTHOR 

HP 
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NAME 

gwindstop - terminate the window helper facility 

SYNOPSIS 

gwindstop [directory] [directory] ~ 

DESCRIPTION 

gwindstop 

destroys windows and their associated pty files from named directories. The windows 
must have been created earlier by xwcreate(l). 

directory 

is the name of the directory where the pty files for the windows reside. If directory name 
is not supplied, /dev/saeen is taken to be the desired directory. Otherwise, if the direc- 
tory argument implies an absolute pathname, then it will be taken to be the desired direc- 
tory. Otherwise, the directory name will be taken to be relative to the value of the environ- 
ment variable $WMDIR. If $WMDIR is not defined in the environment, the directory 
name will be taken to be relative to /dev/screen. Note: if $WMDIR is defined in the 
environment, it must represent an absolute pathname. 

DIAGNOSTICS 

If the windows in the indicated directory are successfully destroyed, then the program remains 
silent. If one or more directories could not be found, an error message ( "Invalid directory") will 
be printed on the standard output. 

ORIGIN 

HP 

SEE ALSO 

xwcreate(l), xwdestroy(l). 
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NAME 

hpterm - X window system Hewlett-Packard terminal emulator. 

SYNOPSIS 

hpterm [-toolkitoption] [-option] 

DESCRIPTION 

The hpterm program is a terminal emulator for the X Window system. It provides a TermO com- 
patible terminal for programs that can't use the window system directly. It also emulates many of 
the block mode features of HP terminals. Refer to the WARNINGS section below for additional 
information about running block mode applications. 

OPTIONS 

The hpterm terminal emulator accepts all of the standard X Toolkit command line options along 
with additional options all of which are listed below (if the option begins with a '+' instead of a '-', 
the option is restored to its default value): 

-b number 

This option specifies the size of the inner border (the distance between the outer edge of 
the character and the window border) in pixels. Associated resource: ♦borderWidth. 

-background color 

This option specifies the color to use for the background of the window. Associated 
resource: ""background. 

-bd color 

This option specifies the color to use for the border of the window. Associated resource: 
♦borderColor. 

-bg color 

This option specifies the color to use for the background of the window. Associated 
resource: ""background. 

-bordenvidth number 

This option specifies the width in pixels of the border surrounding the window. Associ- 
ated resource: "TopLevelShelLborderWidth. 

-bs This option indicates that the "background" of the termO text entry window should be the 

select color that corresponds to the specified background color. Associated resource: 
""backgroundlsSelect. 

+bs This option indicates that the "background" of the termO text entry window should be the 
specified background. Associated resource: ""backgroundlsSelect. 

-bw number 

This option specifies the width in pixels of the border surrounding the window. Associ- 
ated resource: "TopLevelShelLborderWidth. 

-cr color This option specifies the color to use for the text cursor. Associated resource: ""cursor- 
Color. 

-display display 

This option specifies the X server to contact; see X(\). Associated resource: none. 

-e command [arguments ...] 

This option specifies the command (and its command line arguments) to be run in the 
hpterm window. The default is to start the user's shell. This must be the last option on 
the command line. Associated resource: none. 

-tbfont This option specifies a font to be used when displaying bold (alternate) text. This font 
must be the same height and width as the normal (primary) font. If only one of the nor- 
mal (primary) or bold (alternate) fonts is specified, it will be used for both fonts. Refer 
to the NLS section. Associated resource: ""boldFont. 
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-^ color This option specifies the color to use for displaying text. Associated resource: ♦fore- 
ground. 

-fn font This option specifies a font to be used when displaying normal (primary) text. If only 
one of the normal (primary) or bold (alternate) fonts is specified, it will be used for both 
fonts. Refer to the NLS section. Associated resource: *font. 

-font /on; 

This option specifies a font to be used when displaying normal (primary) text. If only 
one of the normal (primary) or bold (alternate) fonts is specified, it will be used for both 
fonts. Associated resource: ♦font. 

-for^round color 

This option specifies the color to use for displaying text. Associated resource: ♦fore- 
ground. 

-geometry geometry 

This option specifies the preferred size and position of the hpterm window, see ^(1). 
Associated resource: ♦termO.geometry. 

-help This option will display a help message. Associated resource: none. 

-i This option indicates that hpterm should supply the window manager with a bitmapped 

icon. Associated resource: bitmaplcoa 

+i This option indicates that the window manager should generate its own icon for hpterm. 

Associated resource: bitmaplcon. 

-iconic This option indicates that hpterm should be placed on the display in icon form. Associ- 
ated resource: ♦termO.iconic. 

+ iconic This option indicates that hpterm should not be placed on the display in icon form. 
Associated resource: ♦termO.iconic. 

-kshmode 

This option indicates that hpterm should convert characters entered with the extend key 
pressed into a two character sequence consisting of an ASCII escape followed by the un- 
extended character. Associated resource: ♦kshMode. 

•1 This option indicates that hpterm should send all terminal output to a log file as well as 

to the screen. Logging may not be enabled when the -L option is used. Associated 
resource: ♦logging. 

+1 This option indicates that hpterm should not do logging. Associated resource: ♦logging. 

•\tfile This option specifies the name of the file to which the output log described above is writ- 
ten, lifile begins with a pipe symbol (|), the rest of the string is assumed to be a com- 
mand to be used as the endpoint of a pipe. The default filename is lApiwmLsi^CXXXX 
(where XXXXX is the process id of hpterm) and is created in the directory from which 
hpterm was started. Associated resource: ♦logFile. 

-Is This option indicates that the shell that is started in the hpterm window should be a login 

shell (i.e. the first character of argv[0] will be a dash, indicating to the shell that it should 
read the user's /etc/profile and .profile (for ksh and sh) or /etc/csh.login and .login (for 
csh). Associated resource: ♦loginShell. 

+Is This option indicates that the shell that is started should not be a login shell (i.e. it will 
be a normal "subshell"). Associated resource: ♦loginShell. 

-map This option indicates that hpterm should map (de-iconify) itself upon pty output if it is 
unmapped (iconified). An initial period of time during which hpterm will not map itself 
upon pty output may be specified via the mapOnOutputDelay resource. Associated 
resource: ♦mapOnOutput. 

+map This option indicates that hpterm should not map (de-iconify) itself upon pty output if it 
is unmapped (iconified). Associated resource: ♦mapOnOutput. 

-mb This option indicates that the pointer cursor should be put into blanking mode. In this 
mode, the cursor will turn on when the pointer is moved, and will be blanked either after 
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a selectable number of seconds or after keyboard input has occurred. The delay is set 
via the pointerBlankDelay resource. Associated resource: *pointerBlaiik. 

+mb This option indicates that the pointer cursor should remain on. Associated resource: 
*pointerBlank. 

-mc mode 

This option determines how hpterm will generate the foreground color, shadow colors, 
and shadow tiles of the scrollbar and softkey widgets. Valid modes are "all", "shadow", 
and "none." Associated resource: '"makeColors. 

-ms color 

This option specifies the color to be used for the pointer cursor. Associated resource: 
♦pointerColor. 

-name name 

This option specifies the application name under which resources are to be obtained, 
rather than the default executable file name ("hpterm"). Associated resource: .name. 

-reverse This option indicates that reverse video should be simulated by swapping the foreground 
and background colors. Associated resource: ♦reverseVideo. 

-rv This option indicates that reverse video should be simulated by swapping the foreground 

and background colors. Associated resource: *reverseVideo. 

+rv This option indicates that reverse video should not be simulated. Associated resource: 
•reverseVideo. 

-sb This option indicates that a scrollbar should be displayed. Associated resource: 

♦scroUBar. 

+ sb This option indicates that a scrollbar should not be displayed. Associated resource: 
•scroHBar. 

-sbbg color 

This option specifies the color to use for the background of the scrollbar window. Asso- 
ciated resource: *scrollBar.bacl^round. 

-sb^ color 

This option specifies the color to use for the foreground of the scrollbar window. This 
value will be ignored if the makeCoIors resource is set to all. Associated resource: 
*scroIlBar.foreground. 

-skbg color 

This option specifies the color to use for the background of the softkey window. Associ- 
ated resource: '"softkey.background. 

-sk^ color 

This option specifies the color to use for displaying softkey text. This value will be 
ignored if the makeColors resource is set to all. Associated resource: 
I'softkey.foreground. 

-skfn/o/j/ 

This option specifies a font to be used when displaying softkey text. Associated resource: 
*softkey.font. 

-si number[suffix] 

This option indicates the number of off screen lines to be saved in the terminal buffer. If 
no suffix is included or the suffix is 1, the total length of the terminal buffer will be 
number plus the length of the terminal window. If the suffix is s the total length of the 
terminal buffer will be (number plus one) times the length of the terminal window. 
Associated resource: *saveLines. 

-ti name This option specifies a name for hpterm to use when identifying itself to application pro- 
grams. Refer to the WARNINGS section for additional information about using hpterm 
with block mode applications. Associated resource: ♦termld. 
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-title ncane 

This option specifies a window title for hpterm. This string may be used by the window 
manager when displaying the application. Associated resource: .TopLevelShelLtitle. 

-tm string 

This option specifies a string containing terminal-setting keywords and the characters to 
which they maybe bound. Associated resource: ♦ttyModes. 

Anname 

This option specifies a name for hpterm to set the $TERM environment variable to. 
Associated resource: *tennNaine. 

-vb This option indicates that a visual bell is preferred over an audible one. Instead of ring- 

ing the terminal bell whenever a Control-G is received, the window will be flashed. 
Associated resource: ♦visualBell. 

-l-vb This option indicates that a visual bell should not be used. Associated resource: ''Visual- 
Bell. 

-xrm resourcestring 

This option specifies a resource string to be used. This is especially useful for setting 
resources that do not have separate command line options. Associated resource: none. 

-C This option indicates that the window should receive console output. The server must be 

authorized to receive console output. See "XConsoles" below for additional informa- 
tion. Associated resource: none. 

-Seen This option specifies the last two letters of the name of a pseudoterminal to use in slave 
mode, and the file descriptor of the pseudoterminal's master. This allows hpterm to be 
used as an input and output channel for an existing program and is sometimes used in 
specialized applications such as pam(l). This option will only work with pty names of 
the form "ttyxx." For example, "-S pOl" specifies "ttypO" on file descriptor 1. Associ- 
ated resource: none. 

-Spty.fd This option specifies the unique portion of the name of a pseudoterminal to use in slave 
mode, and the file descriptor of the pseudoterminal's master. This allows hpterm to be 
used as an input and output channel for an existing program and is sometimes used in 
specialized applications such as pam(l). This option will work for all pty names. For 
example, "-S pO.l" specifies "ttypO" on file descriptor 1 and "-S p02.13" specifies 
"ttyp02" on file descriptor 13. Associated resource: none. 

-U Reserved for internal use. 

-W Reserved for internal use. 

The following command line arguments are provided for compatibility with 

older versions. They may not be supported in future releases as the X Toolkit provides 

standard options that accomplish the same task. 

^geometry 

This option specifies the preferred position of the icon window. It is shorthand for 
specifying the ♦iconGJeometry resource. Associated resource: .iconGeometry. 

-T string This option specifies the title for hpterm's window. It is equivalent to 4itle string. Asso- 
ciated resource: .TopLevelShelLtitle. 

-n string This option specifies the icon name for hpterm's windows. It is shorthand for specifying 
the *iconName resource. Associated resource: ♦iconName. 

-r This option indicates that reverse video should be simulated by swapping the foreground 

and background colors. It is equivalent to -reversevideo or -rv. Associated resource: 
*reverseVideo. 

+ r This option indicates that reverse video should not be simulated. It is equivalent to +rv. 

Associated resource: ♦reverseVideo. 

-w number 

This option specifies the width in pixels of the border surrounding the window. It is 
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equivalent to 4)orderwidth number or -bw number. Associated resource: 
*TopLevelShelLborderWidth. 

RESOURCES 

The hpterm window consists of a Motif shell widget which contains a form widget. The form 
widget contains a termO widget, scrollbar widget, and softkey widget. Resources specific to the 
shell widget are: 



Name 



Class 



hpterm Resource Set 



Type Default 



borderColor BorderColor Pixel black 

borderWidth BorderWidth int 2 

geometry Geometry string 

iconGeometry IconGeometry string 

name Name string hpterm 

title Title string Terminal emulator 



borderColor 

This resource defines the border color of the hpterm window. 

borderWidth 

This resource specifies the width of the hpterm window border. This value may be 
modified by the window manager. 

geometry 

This resource specifies the preferred size and position of the hpterm window. 

iconGeometry 

This resource specifies the preferred size and position oi hpterm when iconified. It is not 
necessarily obeyed by all window managers. 

name This resource specifies the name of the instance of the program. It is used when extract- 
ing resources from the resource database. 

title This resource specifies the window title for hpterm. This string may be used by the win- 
dow manager when displaying this application. 
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L 






termO Resource Set 




Name 


Class 


Type 


Default 


allowSendEvents 


AllowSendEvents 


Boolean 


FALSE 


background 


Background 


Pixel 


"white" 


backgroundlsSelect 


BackgroundlsSelect 


string 


FALSE 


bitmap 


Bitmap 


string 




bitmaplcon 


Bitmaplcon 


Boolean 


FALSE 


boldFont 


Font 


string 


see NLS below 


copyLine 


CopyLine 


string 


"right" 


cursorColor 


Foreground 


Pixel 


"black" 


cut 


Cut 


string 


"left" 


flashBorder 


FlashBorder 


Boolean 


FALSE 


font 


Font 


string 


see NLS below 


foreground 


Foreground 


Pixel 


"black" 


fwAttribute 


SoftkeyAttribute 


int 


2 


f«Label 


SoftkeyLabel 


string 


see below 


&»String 


SoftkeyString 


string 


see below 


halfBrightlnhibit 


HalfBrightlnhibit 


Boolean 


FALSE 


iconic 


Iconic 


Boolean 


FALSE 


intemalBorder 


BorderWidth 


int 


2 


keyboardLanguage 


KeyboardLanguage 


string 


see NLS below 


keyboardLanguageList 


KeyboardLanguageList 


string 


see NLS below 


kshMode 


KshMode 


Boolean 


FALSE 


logFile 


LogFile 


string 


"HptermLogXXXXX" 


logging 


Logging 


Boolean 


FALSE 


loginShell 


LoginShell 


Boolean 


FALSE 


makeColors 


MakeColors 


string 


"none" 


mapOn Output 


AutoMap 


Boolean 


FALSE 


mapOnOutputDelay 


MapDelay 


int 





paste 


Paste 


string 


"middle" 


pointerBlank 


PointerBlank 


Boolean 


FALSE 


pointerBlankDelay 


PointerBlankDelay 


int 


3 


pointerColor 


Foreground 


Pixel 


"black" 


pointerShape 


PointerShape 


string 


"xterm" 


reverseVideo 


ReverseVideo 


Boolean 


FALSE 


romanS 


Romans 


Boolean 


TRUE 


saveLines 


SaveLines 


string 


"Is" 


scrollBar 


ScrollBar 


Boolean 


FALSE 


softkeyInitializel6 


SoftkeyInitializel6 


Boolean 


FALSE 


softkeySelect 


SoftkeySelect 


string 


"left" 


stickyNextCursor 


StickyCursor 


Boolean 


TRUE 


stidQ^PrevCursor 


SticlqCursor 


Boolean 


TRUE 


termid 


Termid 


string 


"X-hpterm" 


termName 


TermName 


string 


"hpterm" 


ttyModes 


TtyModes 


string 


none 


visualBell 


VisualBell 


Boolean 


FALSE 



allowSendEvents 

This resource defines whether synthetic key and button events (generated using the X 
protocol SendEvent request) should be interpreted or discarded. 

background 

This resource defines the background color of the text window. 

backgroundlsSelect 

This resource controls the color used as the "background" of the termO text entry window 
and defaults to False. When False, the background is the color specified. When True, the 
background is the "Select color" that corresponds to the background. For visual 
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consistency with other Motif-based applications, set this resource to True. 

bitmap This resource defines whether hpterm will override its built in bitmap icon with a user 
specified bitmap icon. If the path does not begin with a "/" or "./", it will be processed 
relative to "/usr/lib/Xll/bitmaps". 

bitmaplcon 

This resource defines whether hpterm will supply the window manager with a bitmapped 
icon. The supplied bitmap may be ignored by the window manager. 

boIdFont 

This resource defines the font used for bold (alternate) text. See "NLS" below for 
defaults. 

copyLine 

This resource defines the pointer button/modifier combination to be used to activate the 
CopyLine function. See "POINTER USAGE" below. 

cursorColor 

This resource defines the text cursor color. The pointer cursor color is defined by the 
pointerColor resource. 

cut This resource defines the pointer button/modifier combination to be used to activate the 
Cut function. See "POINTER USAGE" below. 

flashBorder 

This resource defines whether hpterm window border will change color when the pointer 
cursor enters or leaves the window. 

font This resource defines the font used for normal (primary) text. See the 
"termO.fontLanguage (class TermO.FontLanguage) Resource Set" table and "NLS" below 
for defaults. 

foreground 

This resource defines the foreground (text) color of the text window. 

^lAttribute 

This resource defines the softkey attribute for softkey » (1 - 16). If "softkeyInitializel6" is 
true, all 16 softkey attributes can be initialized. If it false, only the first 8 softkey attributes 
can be initialized. 

fitLabel 

This resource defines the softkey label for softkey n (1 - 16). If "softkeyInitializel6" is 
true, all 16 softkey labels can be initialized. If it false, only the first 8 softkey labels can be 
initialized. The default labels for softkeys 1 - 8 are "fl" - "f8." The default labels for soft- 
keys 9-16 are empty. 

&iString 

This resource defines the softkey string for softkey n (1 - 16). If "softkeyInitializel6" is 
true, all 16 softkey strings can be initialized. If it false, only the first 8 softkey strings can 
be initialized. The default strings for softkeys 1 - 8 are "<esc>p" - "<esc>w." The 
default labels for softkeys 9-16 are empty. 

halfBrightlnhibit 

This resource defines whether half-bright enhancements will be not be generated. When 
true, full-bright characters will be used instead of half-bright characters. 

iconic This resource defines whether hpterm will start up in iconic form. 

intemalBorder 

This resource defines the number of pixels between the characters and the window 
border. 

keyboardLanguage 

This resource defines the default keyboard language hpterm should use. See "NLS" 
below for details and defaults. 
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keyboardLanguageList 

This resource defines the list of keyboard languages that may be selected from the termi- 
nal configuration menu. See "NLS" below for detail and defaults. 

kshMode 

This resource defines whether hptenn will operate in ksh mode. In ksh mode, hpterm 
converts characters entered with the extend key pressed into a two-character sequence 
consisting of an ASCII escape followed by the un-extended character. 

logFile This resource defines the name of the file to which a terminal session is logged. The 
default is "HptemiLogXXXZX" (where XOXY is the process id of hpterm). 

logging This resource defines whether a terminal session will be logged. It is also available at 
runtime via the Device Control menu. Logging may not be enabled when the "-L" option 
is used. 

loginShell 

This resource defines whether the shell to be run in the window will be started as a login 
shell (i.e., the first character of argv[0] will be a dash, indicating to the shell that it should 
read the user's /etc/profile and .profile (for ksh and sh) or /etc/csh.login and .login (for 
csh). 

makeColors 

This resource is provided for backward compatibility with older versions of hpterm; since 
it may not be supported in future releases, it is no longer recommended for use. This 
resource defines how the bottomShadowCoIor, for^round, and topShadowColor 
resources of the scrollbar and softkey widgets will be generated and how the foreground 
resource of the termO widget will be generated. If the value of this resource is "all", then 
hpterm will use the value of the background resource of the termO widget to generate a 
value for the foreground, and the background resource of the softkey and scrollbar widg- 
ets to generate values for the bottomShadowColor, foreground, and topShadowColor 
resources such that there is a 3-D look. In this case the topShadoWTile and bottomSha- 
doWTile are always set to "foreground." If the makeColors resource value is "shadow" 
the bottomShadowColor and topShadowColor will be generated but foreground will not 
be generated. If the makeColors resource value is set to "none" then no colors will be 
generated. 

mapOnOutput 

This resource defines whether hpterm will map (de-iconify) itself upon pty output if it is 
unmapped (iconified). An initial period of time during which hpterm will not map itself 
upon pty output may be specified to allow hpterm to not map itself upon initial shell out- 
put. The delay is set via the mapOnOutputDelay resource. 

mapOnOutputDelay 

This resource defines the number of seconds at startup during which hpterm will not map 
(de-iconify) itself upon pty output. 

paste This resource defines the pointer button/modifier combination to be used to activate the 
Paste function. See "POINTER USAGE" below. 

pointerBlank 

This resource defines whether hptenn will put the pointer cursor into blanking mode. In 
blanking mode, the pointer cursor will turn on when the pointer is moved, and will be 
blanked either after a selectable number of seconds or after keyboard input has occurred. 
The delay is set via the pointerBlankDelay resource. 

pointerBIankDelay 

This resource defines the number of seconds to wait before blanking the pointer cursor 
after the pointer has been moved. When set to "0", the pointer will be blanked only upon 
keyboard input. 

pointerColor 

This resource defines the pointer cursor color. The text cursor color is defined by the 
cursorColor resource. 
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pointerShape 

This resource defines the pointer cursor shape. Valid cursor shapes may be found in the 
file "/usr/include/Xll/cursorfont.h." Shapes are specified as the name with the leading 
"XC_" dropped. Valid cursor shapes include "left_ptr", "crosshair", and "xterm." 

reverseVideo 

This resource defines whether reverse video will be simulated by swapping the fore- 
ground and background colors. 

romanS 

This resource controls the mapping of keys to characters and is efifective only for western 
european keyboards. RomanS encoding is used when set to TRUE, ISO 8859-1 encoding 
is used when set to FALSE. (It is the user's responsibility to ensure that correctly 
encoded fonts are used; refer to the discussion on fonts in your Usii^ the X Window Sys- 
tem Manual for more information on font characteristics.) 

saveLines 

This resource defines the number of lines in the terminal buffer beyond the length of the 
window. The resource value consists of a "number'^ followed by an optional "suffix." If 
no suffix is included or the suffix is "1" the total length of the terminal buffer will be 
number plus the length of the terminal window. If the suffix is "s" the total length of the 
terminal buffer will be (number plus one) times the length of the terminal window. 
Hpterm will try to maintain the same buffer to window ratio when the window is resized 
larger. 

scroUBar 

This resource defines whether the scrollbar will be displayed. 

softkeyInitializel6 

This resource enables initialization of all 16 softkeys. If false, only the first 8 softkeys can 
be initialized via resources. 

softkeySelect 

This resource defines the pointer button/modifier combination to be used for selecting 
softkeys. See "POINTER USAGE" below. 

stickyNextCursor 

This resource defines whether the cursor should be homed when the Next key is pressed. 
When true, the cursor will be in the same screen position after the key is pressed that it 
was in before pressing the key. When false, the cursor will be moved to the upper left 
hand comer of the screen after the key is pressed. 

sticl^PrevCursor 

This resource defines whether the cursor should be homed when the Prev key is pressed. 
When true, the cursor will be in the same screen position after the key is pressed that it 
was in before pressing the key. When false, the cursor will be moved to the upper left 
hand comer of the screen after the key is pressed. 

termid This resource defines the name for hpterm to use when identifying itself to application 
programs. Refer to the WARNINGS section for additional information about using 
hpterm with block mode applications. 

temiName 

This resource defines the string for set the "$TERM" environment variable. 

ttyModes 

This resource specifies a string containing terminal-setting keywords and the characters to 
which they may be bound. Allowable keywords include: intr, quit, erase, kill, eof, eol, 
swtch, start, stop, brk, susp, dsusp, rpmt, flush, weras, and Inext. Control characters may 
be specified as ^char (e.g. "c or '^u), and '^? may be used to indicate delete. This is very 
useful for overriding the default terminal settings without having to do an stty every time 
an hpterm is started. 

visualBell 

This resource defines whether a visible bell (i.e. flashing) should be used instead of an 
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term0.fontLanfftage (class TermCFontLanguage) Resource Set 



Name 



Class 



Type Default 



primary.high 


FontPosition.Size 


string 


see NLS below 


primary.mediutn 


FontPosition.Size 


string 


see NLS below 


primary.low 


FontPosition.Size 


string 


see NLS below 


altemate.high 


FontPosition.Size 


string 


see NLS below 


altemate.medium 


FontPosition.Size 


string 


see NLS below 


altemate.low 


FontPosition.Size 


string 


see NLS below 



fontLang^age.pnmary.\ugfi 

This resource defines the default normal (primary) font for displays with high resolution 
monitors. See "NLS" below for additional information. 

/(7n^Lan^age.priinaiy.inedium 

This resource defines the default normal (primary) font for displays with medium resolu- 
tion monitors. See "NLS" below for additional information. 

fontLMng^agcprimaryAow 

This resource defines the default normal (primary) font for displays with low resolution 
monitors. See "NLS" below for additional information. 

/on2:Lan^age.altemate.lugh 

This resource defines the default bold (alternate) font for displays with high resolution 
monitors. See "NLS" below for additional information. 

fontLanguage^\temate.niedmm 

This resource defines the default bold (alternate) font for displays with medium resolu- 
tion monitors. See "NLS" below for additional information. 

fontLanguagejAtemaLteAow 

This resource defines the default bold (alternate) font for displays with low resolution 
monitors. See "NLS" below for additional information. 

The following resources are specified as part of the "softkey" widget (name "softkey", class "Soft- 
key"). For example, the softkey font resource would be specified one of: 

HPterm*softkey*font: hp8.8xl6 
HPterm*Softkey*font: hp8.8xl6 
*Softkey*Font: hp8.8xl6 

Additional resources and information can be found in the XinPrimitive(3X) and CORE(3X) man 
pages along with additional information about the various shadow options. 



Softkey Resource Set 



Name 


Class 


Type 


Default 


background 


Background 


Pixel 


'Vhite" 


bottomShadowColor 


Foreground 


Pixel 


"black" (see below) 


bottomShadowTile 


BottomShadowTile 


string 


"foreground" (see below) 


font 


Font 


string 


(see below) 


foreground 


Foreground 


Pixel 


"black" (see below) 


topShadowColor 


Background 


Pixel 


"white" (see below) 


topShadowTile 


TopShadoWTile 


string 


"50_foreground" (see below) 
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background 

This resource defines the background color of the softkey window. 

bottomShadowCoIor 

This resource defines the color that is combined with the bottom shadow tile and fore- 
ground color to create a pixmap used to draw the bottom and right sides of the softkey 
borders. This may be overridden by the termO makeCoIors resource described above. 

bottomShadoWTile 

This resource defines the tile used in creating the pixmap used for drawing the bottom 
and right shadows for the softkey borders. Valid tile names are described in 
XmCreateTile(3X). This maybe overridden by the termO makeColors resource described 
above. 

font This resource defines the font used for softkey text. The softkey font will default to the 
normal (primary) font of the text window. 

foreground 

This resource defines the foreground (text) color of the softkey window. This may be 
overridden by the termO makeColors resource described above. 

topShadowColor 

This resource defines the color that is combined with the top shadow tile and foreground 
color to create a pixmap used to draw the top and left sides of the softkey borders. This 
may be overridden by the termO makeColors resource described above. 

topShadoWTile 

This resource defines the tile used in creating the pixmap used for drawing the top and 
left shadows for the softkey borders. Valid tile names are described in 
XmCreateTile(3X). This may be overridden by the termO makeColors resource described 
above. 

The following resources are specified as part of the "Xmscrollbar" widget (name "scroUBar", 
class "ScroUBar"). Some example scrollbar resources are: 

HPterm*scrollBar*initialDelay: 10 

HPterm*ScrollBar*RepeatRate: 10 

*ScrollBar* Granularity: 1 

hpterm*scrollBar*width: 20 

Additional resources and information can be found in the XmPrimitive(3X), XmScrollBar(3X), 
XmValuator(3X), and Core(3X) man pages along with additional information about the various 
shadow options. 



Scrollbar Resource Set (name "scroUBar", class "ScroUBar") 


Name 


Class 


Type 


Default 


background 


Background 


Pixel 


"white" 


bottomShadowColor 


Foreground 


Pixel 


"black" (see below) 


bottomShadowTile 


BottomShadowTile 


string 


"foreground" (see below) 


foreground 


Foreground 


Pixel 


"black" (see below) 


granularity 


Granularity 


int 


2 


initialDelay 


InitialDelay 


int 


500 


repeatRate 


RepeatRate 


int 


100 


topShadowColor 


Background 


Pixel 


"white" (see below) 


topShadowTile 


TopShadowTile 


string 


"50 foreground" (see below) 


width 


Width 


int 


10 
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background 

This resource defines the background color of the scrollbar window. 

bottomShadowColor 

This resource defines the color that is combined with the bottom shadow tile and fore- 
ground color to create a pixmap used to draw the bottom and right sides of the scrollbar 
borders. This may be overridden by the termO makeColors resource described above. 

bottomShadoWTile 

This resource defines the tile used in creating the pixmap used for drawing the bottom 
and right shadows for the scrollbar borders. Valid tile names are described in 
XmCreateTile(3X). This maybe overridden by the termO makeColors resource described 
above. 

foreground 

This resource defines the foreground color of the scrollbar window. This may be overrid- 
den by the termO makeColors resource described above. 

granularity 

This resource defines the number of lines to advance the slider when the button is being 
held down on an arrow. The value is defined in milliseconds. 

initialDelay 

This resource defines the delay to wait between the time the button is held down on an 
arrow before the slider starts its repetitive movement. The value is defined in mil- 
liseconds. 

repeatRate 

This resource defines the continuous repeat rate to use to move the slider while the but- 
ton is being held down on an arrow. The value is also defined in milliseconds. 

topShadowColor 

This resource defines the color that is combined with the top shadow tile and foreground 
color to create a pixmap used to draw the top and left sides of the scrollbar borders. This 
maybe overridden by the termO makeColors resource described above. 

topShadoWTile 

This resource defines the tile used in creating the pixmap used for drawing the top and 
left shadows for the scrollbar borders. Valid tile names are described in 
XmCreateTile(3X). This may be overridden by the termO makeColors resource described 
above. 

width This resource defines the width of the scrollbar in pixels. 

POINTER USAGE 

Hpterm allows you to cut and paste text within its own or other windows. All cutting and pasting is 
done using the PRIMARY selection. (To maintain compatability with previous versions of 
hpterm (and other applications that use cut buffers), the cutting and pasting is also done to/from 
the first global cut buffer. When pasting, hpterm gets its text from the PRIMARY selection; if the 
PRIMARY selection is not owned, or the current owner cannot supply the data as text, hpterm will 
try to get its data from the first global cut buffer.) The PRIMARY selection will be disowned 
(and the selected text unhighlighted) under the following conditions: 

1) the cursor is moved anywhere before the end of the selected region 

2) the beginning of the selected region is scrolled off the end of the terminal buffer 

3) the selected region is scrolled across the boundaries of the locked region when 
memory lock is enabled. 

The default button assignments may be changed via various resource strings. The cut and paste 
functions and their default button assignments are: 

Cut The left button is used to "cut" text into the cut buffer. Move the pointer to the 

beginning of the text to cut, press the button, move the cursor to the end of the 
region, and release the button. The "cut" text will not include the character currently 
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under the pointer. 

Paste The middle button "pastes" the text from the cut buffer, inserting it as keyboard 

input. 

CopyLine The right hand button "cuts" the text from the pointer (at button release) through 
the end of line (including the new line), saving it in the cut buffer, and immediately 
"pastes" the line, inserting it as keyboard input. This provides a history mechanism. 

The copyLine, cut, and paste key functions can be configured to any button and modifier combi- 
nation desired via various resources. Each assignment consists of an optional combination of 
modifiers ("none" or any combination of "shift", "meta", "lock", "control", "modi", ..., "mod5" 
separated by blanks), followed by a " | " and the name of the button ("left", "middle", "right", 
"buttonl", ..., "button5"). For example, if it is desired for the cut function to be associated with 
the middle button with shift and control pressed, one could use the following resource line: 

*cut: shift control | middle 

For a full list of resource names, see "RESOURCES" above. 



NLS 



Hptemt currently supports 23 different language versions of the HP keyboard. It is possible to 
switch between different languages via the "terminal configuration" menu. A list of language to 
choose from along with their order is specified via the "keyboardLanguageList" resource. The 
"keyboardLanguageList" resource consists of a list of keyboard languages separated by spaces, 
tabs, or new lines. Valid keyboard languages may be found in the file "/usr/lib/Xll/XHPlib.h." 
Keyboard languages are specified as the language with the leading "KB_" dropped. The default 
value for the "keyboardLanguageList" resource is "US_English Belgian Canada_English Danish 
Dutch Finnish French Canada_French Swiss_French German Swiss_German Italian Norwegian 
Euro_Spanish Latin_Spanish Swedish UK_English Katakana Swiss_French2 Swiss_German2 
Japanese Korean S_Chinese TChinese." 

The initial keyboard language is specified via the "keyboardLanguage" resource. If the string is 
NULL, the language of the server's keyboard will be used. If the keyboard language specified is 
not included in the keyboardLanguageList resource, the first language included in the key- 
boardLanguageList resource will be used. The default is to use the language of the server's key- 
board. 

Hptemt will try to select default fonts which match your monitor and your keyboard language. If 
the normal (primary) and bold (alternate) fonts are specified, they will be used. If only one is 
specified (via either command line options or resources), it will be used for both the normal (pri- 
mary) and bold (alternate) fonts. If neither normal (primary) or bold (altemate) fonts are 
specified, hptemt trys to find them based on the default keyboard language. The default keyboard 
language is indicated on the "terminal configuration" menu. The built in defaults maybe overrid- 
den via the "termO.fontLanguage" resources. FontLanguage varies with the keyboard language as 
follows. 

keyboard language fontLanguage 

Katakana hp_kana8 

Japanese hpjapanese 

Korean hp_korean 

T_Chinese hp_chinese_t 

S_Chinese hp_chinese_s 
all others HP keyboards hpromanS 

non HP keyboards iso_8859_l 

The default font size used will depend upon the resolution of the monitor as follows: 
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monitor resolution font size 

72 DPI or less low 

greater than 72 DPI and less 100 DPI medium 

100 DPI or greater high 

For example, resource specifications for the US_English, German, and Finnish keyboards would 
be: 

HPterm*hp_roman8.primary.high: *courier-medium-r-normal~14*hp-roman8 

HPtenn*hp_roman8.primary.medium: *courier-medium-r-normal-12*hp-roman8 

HPterm*hp_roman8.primary.low: *courier-medium-r-nonnal— 8*hp-roman8 

HPterm*hp_roman8.altemate.high: *courier-bold-r-normal— 14*hp-roman8 

HPterm*hp_roman8.altemate.medium: *courier-bold-r-normal— 12*hp-roman8 

HPterm*hp_roman8.altemate.low: *courier-bold-r-normal— 8*hp-roman8 

For the Japanese keyboard, resource specifications would be: 

HPterm*hpJapanese.primary.high: jpn.8xl8 

HPterm*hpJapanese.primary.medium: jpn.8xl8 

HPterm*hpjapanese.primary.low: jpn.8xl8 

HPterm'hpJapanese.altemate.high: math.8xl8 

HPterm*hpjapanese.altemate.medium: math.SxlS 

HPterm*hpJapanese.altemate.low: math.8xl8 

If these fonts can not be found, the font "fixed" will be used for both the normal (primary) and 
bold (alternate) fonts. These resources are for font defaults only and will be ignored if either the 
normal (primary) or bold (alternate) fonts are specified. 

Control-N will switch to the bold (alternate) font and control-O will switch back to the normal 
(primary) font. Hptertn will switch back to the normal (primary) font automatically at the begin- 
ning of each line. 

XCONSOLES 

It is possible to configure a system to allow redirection of console output (and input) to an hptertn 
window. If the "-C" option is used, hpterm will redirect console output (and input) if: 

Hptertn is displaying on the local system. Hptertn must be running on the same system as 
the server that is displaying the window. 

The display is authorized. The display number of the display name (see "Display 
Specification" in Ar(l)) must be authorized to take control of the console via the file 
"/usr/lib/Xll/Xconsoles." The file is parsed as follows: 

A '#' and all following text on a line are ignored. 

Blank lines are ignored. 

Leading tabs and spaces are ignored. 

A number matching the display number authorizes the server to redirect con- 
sole output (and input). 

An asterisk ('*') matches all display numbers and authorizes the server to 
redirect console output (and input). 

If either condition is not met, a warning will be written to stderr and console output (and input) 
will not be redirected. 

WARNINGS 

When running block mode applications, it maybe necessary for hptertn to identify itself to applica- 
tion programs as some terminal other than "X-hpterm." Most applications understand the 
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terminal id "2392A." Newer applications also understand the terminal id "IQO/^" while older 
applications may only understand the terminal id "2622A." To set the terminal identification 
string, use the "-ti" command line option, the "termid" resource, or the "Termid" class. 

The overflow protect mode of memory lock is not supported. 

ENVIRONMENT 

Hpterm sets the environment variables "$LINES" and "$COLUMNS" to the number of lines and 
columns of the terminal screen. It also uses and sets the environment variable "$DISPLAY" to 
specify its server connection. The Ksize(V) command may be used to reset "$LINES" and 
"$COLUMNS" after the window size has been changed. 

ORIGIN 

Hewlett-Packard Company ITO. 

SEE ALSO 

X(l), resize(l), xset(l), xterm(l), pty(4), Core(3X), XmScroIIBar(3X), XmPrimitive(3X), 
XmCreateTiIe(3X), XmValuator(3X), XmArrow(3X). 
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NAME 

mkfontdir - create fonts.dir file from directory of font files. 

SYNOPSIS 

mkfontdir [directory-names] 

DESCRIPTION 

For each directory argument, mkfontdir reads all of the font files in the directory searching for 
properties named TONT", or (failing that) the name of the file stripped of its suffix. These are 
used as font names, which are written out to the file "fonts.dir" in the directory along with the 
name of the font file. Without a "fonts.dir" file, the server will not be able to access the font files 
in the directory. 

The kinds of font files read by mkfontdir depends on configuration parameters, but typically 
include SNF (suffix ".snf"), compressed SNF (suffix ".snf.Z", or ".scf"), BDF (suffix ".bdfO, and 
compressed BDF (suffix ".bdf.Z*^. If a font exists in multiple formats, the most efficient format 
will be used. 

FONT NAME ALIASES 

The file "fonts.alias" which can be put in any directory of the font-path is used to map new names 
to existing fonts, and should be edited by hand. The format is straight forward enough, two 
white-space separated columns, the first containing aliases and the second containing font-name 
patterns. 

When a font alias is used, the name it references is searched for in the normal manner, looking 
through each font directory in turn. This means that the aliases need not mention fonts in the 
same directory as the alias file. 

To embed white-space in either name, simply enclose them in double-quote marks, to embed 
double-quote marks (or any other character), precede them with back-slash: 

"magic-alias with spaces" "\"font\name\" with quotes" 
regular-alias fixed 

If the string "FILE_NAMES_ALIASES" stands alone on a line, each file-name in the directory 
(stripped of it's .snf suffix) will be used as an alias for that font. 

USAGE 

Xserver(l) looks for both "fonts.dir" and "fonts.alias" in each directory in the font path each time it 
is set (see xset(l)). 

SEE ALSO 

X(l), Xserver(l), xset(l) 
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NAME 

mwm - The Motif Window Manager. 

SYNOPSIS 

mwm [options] 

DESCRIPTION 

mwm is an X Window System client that provides window management functionality and some 
session management functionality. It provides functions that facilitate control (by the user and the 
programmer) of elements of window states such as placement, size, icon/normal display, and 
input-focus ownership. It also provides session management functions such as stopping a client. 

Options 

-display display 

This option specifies the display to use; see ^"(7). 

-xrm resourcestring 

This option specifies a resource string to use. 

•multiscreen 

This option causes mwm to manage all screens on the display. The default is to manage 
only a single screen. 

-name name 

This option causes mwm to retrieve its resources using the specified name, as in 
name*resource. 

-screens name [name [...]] 

This option specifies the resource names to use for the screens managed by mwm. If 
mwm is managing a single screen, only the first name in the list is used. If mwm is 
managing multiple screens, the names are assigned to the screens in order, starting with 
screen 0. Screen gets the first name, screen 1 the second name, and so on. 

Appearance 

icons, the icon box, input focus, and window stacking. The appearance and behavior of the win- 
dow manager can be altered by changing the configuration of specific resources. Resources are 
defined under the heading "X DEFAULTS." 

Screens 

By default, mwm manages only the single screen specified by the -display option or the DISPLAY 
environment variable (by default, screen 0). If the -multiscreen option is specified or if the mul- 
tiscreen resource is True, mwm tries to manage all the screens on the display. 

When mwm is managing multiple screens, the -screens option can be used to give each screen a 
unique resource name. The names are separated by blanks, e.g., -screens mwmO mwml. If there 
are more screens than names, resources for the remaining screens will be retrieved using the first 
name. 

Windows 

Default mwm window frames have distinct components with associated functions: 

Title Area In addition to displaying the client's title, the title area is 

used to move the window. To move the window, place the 
pointer over the title area, press button 1 and drag the win- 
dow to a new location. A wire frame is moved during the 
drag to indicate the new location. When the button is 
released, the window is moved to the new location. 

Title Bar The title bar includes the title area, the minimize button, the 

maximize button and the window menu button. 

Minimize Button To turn the window into an icon, click button 1 on the 

minimize button (the frame box with a small square in it). 
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Maximize Button 



Window Menu Button 



To make the window fill the screen (or enlarge to the largest 
size allowed by the configuration files), click button 1 on the 
maximize button (the frame box with a large square in it). 

The window menu button is the frame box with a horizontal 
bar in it. To pull down the window menu, press button 1. 
While pressing, drag the pointer on the menu to your selec- 
tion, then release the button when your selection is 
highlighted. Alternately, you can click button 1 to pull down 
the menu and keep it posted; then position the pointer and 
select. 



Resize Border Handles 



Matte 



Icons 



Default Window Menu { 


Selection 


Accelerator 


Description 


Restore 


Alt+F5 


Restores the window to its size before 
minimizing or maximizing 


Move 


Alt+F7 


Allows the window to be moved with keys 
or mouse 


Size 


Alt+F8 


Allows the window to be resized 


Minimize 


Alt+F9 


Turns the window into an icon 


Maximize 


Alt+FlO 


Makes the window fill the screen 


Lxjwer 


Alt+F3 


Moves window to bottom of window stack 


Close 


Alt+F4 


Causes client to terminate 



To change the size of a window, move the pointer over a 
resize border handle (the cursor changes), press button 1, 
and drag the window to a new size. When the button is 
released, the window is resized. While dragging is being 
done, a rubber-band outline is displayed to indicate the new 
window size. 

An optional matte decoration can be added between the 
client area and the window frame. A matte is not actually 
part of the window frame. There is no functionality associ- 
ated with a matte. 



Icons are small graphic representations of windows. A window can be minimized (iconified) using 
the minimize button on the window frame. Icons provide a way to reduce clutter on the screen. 

Pressing mouse button 1 when the pointer is over an icon causes the icon's window menu to pop 
up. Releasing the button (press + release without moving mouse = click) causes the menu to stay 
posted. The menu contains the following selections: 
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Icon Window Menu { 


Selection 


Accelerator 


Description 


Restore 


Alt+F5 


Opens the associated window 


Move 


Alt+F7 


Allows the icon to be moved with keys 


Size 


Alt+F8 


Inactive (not an option for icons) 


Minimize 


Alt+F9 


Inactive (not an option for icons) 


Maximize 


Alt+FlO 


Opens the associated window and 
makes it fill the screen 


Lower 


Alt+F3 


Moves icon to bottom of icon stack 


Close 


Alt+F4 


Removes client from mwm management 



Note that pressing button 3 over an icon also causes the icon's window menu to pop up. To make 
a menu selection, drag the pointer over the menu and release button 3 when the desired item is 
highlighted. 

Double-clicking button 1 on an icon normalizes the icon into its associated window. Double- 
clicking button 1 on the icon box's icon opens the icon box and allow access to the contained icons. 
(In general, double-clicking a mouse button is a quick way to perform a function.) Double- 
clicking button 1 with the pointer on the window menu button closes the window. 

Icon Box 

When icons begin to clutter the screen, they can be packed into an icon box. (To use an icon box, 
mvmi must be started with the icon box configuration already set.) The icon box is a mwm window 
that holds client icons. It includes one or more scroll bars when there are more window icons 
than the icon box can show at the same time. 

Icons in the icon box can be manipulated with the mouse. The following table summarizes the 
behavior of this interface. Button actions apply whenever the pointer is on any part of the icon. 
Note that invoking the f.raise function on an icon in the icon box raises an already open window to 
the top of the stack. 



Button Action 



Description 



Button 1 click 



Selects the icon 



Button 1 double click Normalizes (opens) the associated window 

Button 1 double click Raises an already open window to the top 
of the stack 

Button 1 drag Moves the icon 

Button 3 press Causes the menu for that icon to pop up. 

Button 3 drag Highlights items as the pointer moves 

across the menu. 



Pressing mouse button 3 when the pointer is over an icon causes the menu for that icon to pop up. 
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Icon Menu for the Icon Box { 


Selection 


Accelerator 


Description 


Restore 


Alt+F5 


Opens the associated window (if not already open). 


Move 


AIt+F7 


Allows the icon to be moved with keys. 


Size 


Alt+F8 


Inactive. 


Minimize 


Alt+F9 


Inactive. 


Maximize 


Alt+FlO 


Opens the associated window (if not already open) 
and maximizes its size. 


Lower 


Alt+F3 


Inactive. 


Close 


Alt+F4 


Removes client from mwm management. 



To pull down the window menu for the icon box itself, press button 1 with the pointer over the 
menu button for the icon box. The window menu of the icon box differs from the window menu of 
a client window: The "Close" selection is replaced with the Tacklcons Shift + Alt +F7" selection. 
When selected, Packlcons packs the icons in the box to achieve neat rows with no empty slots. 

Pressing [Shift][Escape] when the icon box has the input focus causes the window menu of the icon 
box to pop up. Pressing F4 (the pop-up menu key) causes the window menu of the currently 
selected icon to pop up. 

Input Focus 

mwm supports (by default) a keyboard input focus policy of explicit selection. This means when a 
window is selected to get keyboard input, it continues to get keyboard input until the window is 
withdrawn from window management, another window is explicitly selected to get keyboard input, 
or the window is iconified. Several resources control the input focus. The client window with the 
keyboard input focus has the active window appearance with a visually distinct window frame. 

The following tables summarize the keyboard input focus selection behavior: 



Button Action 


Object 


F\inction Description 


Button 1 press 


Window / window frame 


Keyboard focus selection 


Button 1 press 


Icon 


Keyboard focus selection 



Key Action 


Function Description 


[Alt]|Tab] 


Move input focus to next window in window stack 


[Alt][Shift](Tab] 


Move input focus to previous window in window stack 



X Defaults 

mwm is configured from its resource database. This database is built from the following sources. 
They are listed in order of precedence, low to high: 

/usr/lib/Xll/app-defaults/Mwm 

$HOME/Mwm 

RESOURCEMANAGER root window property or $HOME/.Xdefaults 

XENVIRONMENT variable or $HOME/.Xdefaults-/j05f 

mwm command line options 

The file names /usr/lib/Xll/app-defaults/Mwm and $HOME/Mwm represent customary loca- 
tions for these files. The actual location of the system-wide class resource file may depend on the 
XFILESEARCHPATH environment variable and the current language environment. The actual 
location of the user-specific class resource file may depend on the XUSERFILESEARCHPATH 
and XAPPLRESDIR environment variables and the current language environment. 

Entries in the resource database may refer to other resource files for specific types of resources. 
These include files that contain bitmaps, fonts, and mwm specific resources such as menus and 
behavior specifications (for example, button and key bindings). 

Mwm is the resource class name of mwm and mwm is the resource name used by mwm to look up 
resources. (For looking up resources of multiple screens, the -screens command line option 
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specifies resource names, such as "mwm_b+w" and "mwm_color".) In the following discussion of 
resource specification, "Mwm" and''mwm" (and the aliased mwm resource names) can be used 
interchangeably, but "mwm" takes precedence over "Mwm". 

mwm uses the following types of resources: 

Component Appearance Resources: 

These resources specify appearance attributes of window manager user interface components. 
They can be applied to the appearance of window manager menus, feedback windows (for exam- 
ple, the window reconfiguration feedback window), client window frames, and icons. 

Specific Appearance and Behavior Resources: 

These resources specify mwm appearance and behavior (for example, window management poli- 
cies). They are not set separately for diflferent mwm user interface components. 

Client Specific Resources: 

These mwm resources can be set for a particular client window or class of client windows. They 
specify client-specific icon and client window frame appearance and behavior. 

Resource identifiers can be either a resource name (for example, foreground) or a resource class 
(for example. Foreground). If the value of a resource is a filename and if the filename is prefixed 
by ""/", then it is relative to the path contained in the HOME environment variable (generally the 
user's home directory). 

Component Appearance Resources 

The syntax for specifying component appearance resources that apply to window manager icons, 
menus, and client window frames is 

Msvm*resourceJd 

For example, Mwm*for^round is used to specify the foreground color for mwm menus, icons, 
client window frames, and feedback dialogs. 

The syntax for specifying component appearance resources that apply to a particular mwm com- 
ponent is 

Mwm'*'[menu | icon | client | feedback]*r«OMrcejrf 

If menu is specified, the resource is applied only to mwm If menu is specified, the resource is 
applied only to MWM menus; if icon is specified, the resource is applied to icons; and if client is 
specified, the resource is applied to client window frames. For example, Mwrn^icon^foreground is 
used to specify the foreground color for mwm icons, Mwm*menu*foreground specifies the fore- 
ground color for mwm menus, and Mwm*client*foreground is used to specify the foreground 
color for mwm client window frames. 

The appearance of the title area of a client window frame (including window management but- 
tons) can be separately configured. The syntax for configuring the title area of a client window 
frame is: 

Mwm*cIient*title*re50MrcejV/ 

For example, Mwm*cIient*titIe*foreground specifies the foreground color for the title area. 
Defaults for title area resources are based on the values of the corresponding client window frame 
resources. 

The appearance of menus can be configured based on the name of the menu. The syntax for 
specifying menu appearance by name is: 

Mymi*metm*menu_narne*resourcejd 

For example, Mwm*menu*my_menu*foreground specifies the foreground color for the menu 
named my_menu. 

The following component appearance resources that apply to all window manager parts can be 
specified: 
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Component Appearance Resources - All Mlndow Manager Parts | 


Name 


Class 


Value Type 


Default 


background 


Background 


color 


variesf 


backgroundPixmap 


BackgroundPixmap 


stringtt;variest 




bottomShadowColor 


Foreground 


color 


variest 


bottomShadowPixmap 


BottomShadowPixmap 


stringtt;variest 




fontList 


FontList 


stringttt 


"fixed" 


foreground 


Foreground 


color 


variest 


saveUnder 


SaveUnder 


T/F 


F 


topShadowColor 


Background 


color 


variest 


topShadowPixmap 


TopShadowPixmap 


stringtt 


variest 



fThe default is chosen based on the visual type of the screen, 
ttlmage name. See XmInstallImage(3X). 
tttXll R4 Font description. 

background (class Background) 

This resource specifies the background color. Any legal X color may be specified. The 
default value is chosen based on the visual type of the screen. 

backgroundPixmap (class BackgroundPixmap) 

This resource specifies the background Pixmap of the mwm decoration when the window 
is inactive (does not have the keyboard focus). The default value is chosen based on the 
visual type of the screen. 

bottomShadowColor (class Foreground) 

This resource specifies the bottom shadow color. This color is used for the lower and 
right bevels of the window manager decoration. Any legal X color may be specified. The 
default value is chosen based on the visual type of the screen. 

bottomShadowPixmap (class BottomShadowPixmap) 

This resource specifies the bottom shadow Pixmap. This Pixmap is used for the lower 
and right bevels of the window manager decoration. The default is chosen based on the 
visual type of the screen. 

fontList (class FontList) 

This resource specifies the font used in the window manager decoration. The character 
encoding of the font should match the character encoding of the strings that are used. 
The default is "fixed." 

foreground (class Foreground) 

This resource specifies the foreground color. The default is chosen based on the visual 
type of the screen. 

saveUnder (class SaveUnder) 

This is used to indicate whether "save unders" are used for mwm components. For this 
to have any effect, save unders must be implemented by the X server. If save unders are 
implemented, the X server saves the contents of windows obscured by windows that have 
the save under attribute set. If the saveUnder resource is True, mwm will set the save 
under attribute on the window manager frame of any client that has it set. If saveUnder 
is False, save unders will not be used on any window manager frames. The default value 
is False. 

topShadowColor (class Background) 

This resource specifies the top shadow color. This color is used for the upper and left 
bevels of the window manager decoration. The default is chosen based on the visual type 
of the screen. 

topShadowPixmap (class TopShadowPixmap) 

This resource specifies the top shadow Pixmap. This Pixmap is used for the upper and 
left bevels of the window manager decoration. The default is chosen based on the visual 
type of the screen. 
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The following component appearance resources that apply to frame and icons can be specified: 



Frame and Icon Components { 


Name 


Class 


Value I^pe 


Default 


activeBackground 


Background 


color 


variest 


activeBackgroundPixmap 


BackgroundPixmap 


stringtt 


variest 


activeBottomShadowColor 


Foreground 


color 


variest 


activeBottomShadowPixmap 


BottomShadowPixmap 


stringtt 


variest 


activeForeground 


Foreground 


color 


variest 


activeTopShadowColor 


Background 


color 


variest 


activeTopShadowPixmap 


TopShadowPixmap 


stringtt 


variest 



fThe default is chosen based on the visual type of the screen. 
ttSee XmInstallImage(3X). 

activeBackground (class Background) 

This resource specifies the background color of the mwm decoration when the window is 
active (has the keyboard focus). The default is chosen based on the visual type of the 
screen. 

activeBackgroundPixmap (class ActiveBackgroundPixmap) 

This resource specifies the background Pixmap of the mwm decoration when the window 
is active (has the keyboard focus). The default is chosen based on the visual type of the 
screen. 

activeBottomShadowColor (class Foreground) 

This resource specifies the bottom shadow color of the mwm decoration when the win- 
dow is active (has the keyboard focus). The default is chosen based on the visual type of 
the screen. 

activeBottomShadowPixmap (class BottomShadowPixmap) 

This resource specifies the bottom shadow Pixmap of the mwm decoration when the win- 
dow is active (has the keyboard focus). The default is chosen based on the visual type of 
the screen. 

activeForeground (class Foreground) 

This resource specifies the foreground color of the mwm decoration when the window is 
active (has the keyboard focus). The default is chosen based on the visual type of the 
screen. 

activeTopShadowColor (class Background) 

This resource specifies the top shadow color of the mwm decoration when the window is 
active (has the keyboard focus). The default is chosen based on the visual type of the 
screen. 

activeTopShadowPixmap (class TopShadowPixmap) 

This resource specifies the top shadow Pixmap of the mwm decoration when the window 
is active (has the keyboard focus). The default is chosen based on the visual type of the 
screen. 

Specific Appearance And Behavior Resources 

The syntax for specifying specific appearance and behavior resources is 

M\¥m*resourceJd 

For example, Mwm*keyboardFocusPolicy specifies the window manager policy for setting the key- 
board focus to a particular client Avindow. 

The following specific appearance and behavior resources can be specified: 
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Specific Appearance and Behavior Resources | 


Name 


Class 


Value Type 


Default 


autoKeyFocus 


AutoKeyFocus 


T/F 


T 


autoRaiseDelay 


AutoRaiseDelay 


millisec 


500 


bitmapDirectory 


BitmapDirectory 


directory 


/usr/include/Xl 1/bitmaps 


buttonBindings 


ButtonBindings 


string 


"DefaultButtonBindings" 


cleanText 


CleanText 


T/F 


T 


clientAutoPlace 


ClientAutoPlace 


T/F 


T 


colormapFocusPoIicy 


ColormapFocusPoIicy 


string 


keyboard 


configPile 


ConfigFile 


file 


.mwmrc 


deiconifyKeyFocus 


DeiconifyKeyFocus 


T/F 


T 


doubleClickTime 


DoubleClickTime 


millisec. 


multi-click time 


enableWarp 


enableWarp 


T/F 


T 


enforceKeyFcKus 


EnforceKeyFocus 


T/F 


T 


fadeNormallcon 


FadeNormallcon 


T/F 


F 


frameBorderWidth 


FrameBorderWidth 


pixels 


5 


iconAutoPlace 


IconAutoPlace 


T/F 


T 


iconBoxGeometry 


IconBoxGeometry 


string 


6x1+0-0 


iconBoxName 


IconBoxName 


string 


iconbox 


iconBoxSBDisplayPolicy 


IconBoxSBDisplayPolicy 


string 


all 


iconBoxTitle 


IconBoxTitle 


XmString 


Icons 


iconClick 


IconClick 


T/F 


T 


iconDecoration 


IconDecoration 


string;varies 




iconlmageMaximum 


IconlmageMaximum 


wxh 


50x50 


iconlmageMinimum 


IconlmageMinimum 


wxh 


16x16 


iconPlacement 


IconPlacement 


string 


left bottom 


iconPlacementMargin 


IconPlacementMargin 


pixels 


vanes 


interactivePlacement 


InteractivePlacement 


T/F 


F 


keyBindings 


KeyBindings 


string 


"DefaultKeyBindings" 


keyboardFocusPolicy 


KeyboardFocusPolicy 


string 


explicit 


limitResize 


LimitResize 


T/F 


T 


lowerOnlconify 


LowerOnlconify 


T/F 


T 


maxitnumMaximumSize 


MaximumMaximumSize 


wxh (pixels) 


2X screen 
w&h 


moveThreshold 


MoveThreshold 


pixels 


4 


multiscreen 


Multiscreen 


T/F 


F 


passButtons 


PassButtons 


T/F 


F 


passSelectButton 


PassSelectButton 


T/F 


T 


positionlsFrame 


PositionlsFrame 


T/F 


T 


positionOnScreen 


PositionOnScreen 


T/F 


T 


quitTimeout 


QuitTimeout 


millisec. 


1000 


raiseKeyFocus 


RaiseKeyFocus 


T/F 


F 


resizeBorderWidth 


ResizeBorderWidth 


pixels 


10 


resizeCursors 


ResizeCursors 


T/F 


T 


screens 


Screens 


string 


vanes 


showFeedback 


ShowFeedback 


string 


-kill 


startupKeyFocus 


StartupKeyFocus 


T/F 


T 


transientDecoration 


TransientDecoration 


string 


system 
title 
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transientFunctions 


TransientFunctions 


string 


-minimize 
-maximize 


uselconBox 


UselconBox 


T/F 


F 


wMenuButtonClick 


WMenuButtonClick 


T/F 


T 


wMenuButtonClick2 


WMenuButtonCIick2 


T/F 


T 



autoKeyFocus (class AutoK^Focus) 

This resource is available only when the keyboard input focus policy is explicit If 
autoKeyFocus is given a value of True, then when a window with the keyboard input 
focus is withdrawn from window management or is iconified, the focus is set to the previ- 
ous window that had the focus. If the value given is False, there is no automatic setting 
of the keyboard input focus. The default value is True. 

autoRaiseDelay (class AutoRaiseDelay) 

This resource is available only when the focusAutoRaise resource is True and the key- 
board focus policy is pointer. The autoRaiseDelay resource specifies the amount of time 
(in milliseconds) that mwm will wait before raising a window after it gets the keyboard 
focus. The default value of this resource is 500 (ms). 

bitmapDirectory (class BitmapDirectory) 

This resource identifies a directory to be searched for bitmaps referenced by mwm 
resources. This directory is searched if a bitmap is specified without an absolute path- 
name. The default value for this resource is /usr/include/Xll/bitmaps. 

buttonBindings (class ButtonBindings) 

This resource identifies the set of button bindings for window management functions. 
The named set of button bindings is specified in the mwm resource description file. 
These button bindings are merged with the built-in default bindings. The default value 
for this resource is "DefaultButtonBindings". 

cleanText (classCleanText) 

This resource controls the display of window manager text in the client title and feedback 
windows. If the default value of True is used, the text is drawn with a clear (no stipple) 
background. This makes text easier to read on monochrome systems where a back- 
groundPixmap is specified. Only the stippling in the area immediately around the text is 
cleared. If False, the text is drawn directly on top of the existing background. 

clientAutoPlace (class ClientAutoFIace) 

This resource determines the position of a window when the window has not been given 
a user specified position. With a value of True, windows are positioned with the top left 
comers of the frames offset horizontally and vertically. A value of False causes the 
currently configured position of the window to be used. In either case, mwm will attempt 
to place the windows totally on-screen. The default value is True. 

colormapFocusPoIicy (class ColormapFocusPolicy) 

This resource indicates the colormap focus policy that is to be used. If the resource 
value is explicit, a colormap selection action is done on a client window to set the color- 
map focus to that window. If the value is pointer, the client window containing the 
pointer has the colormap focus. If the value is keyboard, the client window that has the 
keyboard input focus has the colormap focus. The default value for this resource is key- 
board. 

configFile (class ConfigFile) 

The resource value is the pathname for an mwm resource description file. 

If the pathname begins with ""/", mwm considers it to be relative to the user's home 
directory (as specified by the HOME environment variable). If the LANG environment 
variable is set, mwm looks for $HOME/$LAkNG/configFile. If that file does not exist or 
if LANG is not set, mwm looks for SHOME/configFile. 

If the configFile pathname does not begin with ""/", mwm considers it to be relative to 
the current working directory. 
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If the conngFile resource is not specified or if that file does not exist, mwm uses several 
default paths to find a configuration file. If the LANG environment variable is set, mwm 
looks for the configuration file first in $HOME/$LANG/.mwmrc. If that file does not 
exist or if LANG is not set, mwm looks for $HOME/.mwmrc. If that file does not exist 
and if LANG is set, mwm next looks for /usr/lib/Xll/$LANG/system.mwmrc. If that 
file does not exist or if LANG is not set, mwm looks for /usr/lib/Xll/system.mwmrc. 

deiconifyKeyFocus (class DeiconifyKeyFocus) 

This resource applies only when the keyboard input focus policy is e;q)licit. If a value of 
True is used, a window receives the keyboard input focus when it is normalized 
(deiconified). True is the default value. 

doubleClickTime (class DoubleClickTime) 

This resource is used to set the maximum time (in ms) between the clicks (button 
presses) that make up a double-click. The default value of this resource is the display's 
multi-click time. 

enableWarp (class EnableWarp) 

The default value of this resource. True, causes mwm to "warp" the pointer to the center 
of the selected window during keyboard-controlled resize and move operations. Setting 
the value to False causes mwm to leave the pointer at its original place on the screen, 
unless the user explicitly moves it with the cursor keys or pointing device. 

enforceKeyFocus (class EnforceKeyFocus) 

If this resource is given a value of True, the keyboard input focus is always ej5)licitly set 
to selected windows even if there is an indication that they are "globally active" input win- 
dows. (An example of a globally active window is a scroll bar that can be operated 
without setting the focus to that client.) If the resource is False, the keyboard input focus 
is not explicitly set to globally active -windows. The default value is True. 

fadeNormallcon (class FadeNormallcon) 

If this resource is given a value of True, an icon is grayed out whenever it has been nor- 
malized (its window has been opened). The default value is False. 

frameBorderWidth (class FrameBorderWidth) 

This resource specifies the width (in pixels) of a client window frame border without 
resize handles. The border width includes the 3-D shadows. The default value is 5 pix- 
els. 

iconAutoPlace (class IconAutoFlace) 

This resource indicates whether the window manager arranges icons in a particular area 
of the screen or places each icon where the window was when it was iconif ied. The value 
True indicates that icons are arranged in a particular area of the screen, determined by 
the iconPlacement resource. The value False indicates that an icon is placed at the loca- 
tion of the window when it is iconified. The default is True. 

iconBoxCkometry (class IconBoxCl«ometry) 

This resource indicates the initial position and size of the icon box. The value of the 
resource is a standard window geometry string with the following syntax: 

[=][widthTiheight][{ + -yxoffseti + -}yoffset] 

If the offsets are not provided, the iconPlacement policy is used to determine the initial placement. 
The units for width and height are columns and rows. 

The actual screen size of the icon box window depends on the iconlmageMaximum (size) and 
iconDecoration resources. The default value for size is (6 * iconWidth + padding) wide by (1 * 
iconHeight + padding) high. The default value of the location is +0-0. 

iconBoxName (class IconBoxName) 

This resource specifies the name that is used to look up icon box resources. The default 
name is "iconbox". 

iconBoxSBDispIayPolicy (class IconBoxSBDisplayPolicy) 

This resource specifies the scroll bar display policy of the window manager in the icon 
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box. The resource has three possible values: all, vertical, and horizontal- The default 
value, "air, causes both vertical and horizontal scroll bars always to appear. The value 
"vertical" causes a single vertical scroll bar to appear in the icon box and sets the orienta- 
tion of the icon box to horizontal (regardless of the iconBoxGeometry specification). 
The value "horizontal" causes a single horizontal scroll bar to appear in the icon box and 
sets the orientation of the icon box to vertical (regardless of the iconBoxGeometry 
specification). 

iconBojiTitle (class IconBoj^^'itle) 

This resource specifies the name that is used in the title area of the icon box frame. The 
default value is "Icons". 

iconClick (class IconClick) 

When this resource is given the value of True, the system menu is posted and left posted 
when an icon is clicked. The default value is True. 

iconDecoration (class IconDecoration) 

This resource specifies the general icon decoration. The resource value is label (only the 
label part is displayed) or image (only the image part is displayed) or label image (both 
the label and image parts are displayed). A value of activelabel can also be specified to 
get a label (not truncated to the width of the icon) when the icon is selected. The default 
icon decoration for icon box icons is that each icon has a label part and an image part 
(label image). The default icon decoration for stand-alone icons is that each icon has an 
active label part, a label part and an image part (activelabel label image). 

iconlmageMaximum (class IconlmageMaximum) 

This resource specifies the maximum size of the icon image. The resource value is 
widthsheight (for example, 64x64). The maximum supported size is 128x128. The default 
value of this resource is 50x50. 

konlmageM inimum (class IconlmageMinimum) 

This resource specifies the minimum size of the icon image. The minimum supported 
size is 16x16. The default value of this resource is 16x16. 

iconPIacement (class IconPlacement) 

This resource specifies the icon placement scheme to be used. The resource value has 
the following syntax: 

primary Jayout secondary Jayout 
The layout values are one of the following: 



Value 


Description 


top 


Lay the icons out top to bottom. 


bottom 


Lay the icons out bottom to top. 


left 


Lay the icons out left to right. 


right 


Lay the icons out right to left. 



A horizontal (vertical) layout value should not be used for both the primary Jayout and 
the secondary Jayout (for example, don't use top for the primary Jayout and bottom for 
the secondary Jayout). Th& primary Jayout indicates whether, when an icon placement is 
done, the icon is placed in a row or a column and the direction of placement. The 
secondary Jayout indicates where to place new rows or columns. For example, top right 
indicates that icons should be placed top to bottom on the screen and that columns 
should be added from right to left on the screen. The default placement is left bottom 
(icons are placed left to right on the screen, with the first row on the bottom of the 
screen, and new rows added from the bottom of the screen to the top of the screen). 

IconPlacementMargin (class IconPiacementMargin) 

This resource sets the distance between the edge of the screen and the icons that are 
placed along the edge of the screen. The value should be greater than or equal to 0. A 
default value (see below) is used if the value specified is invalid. The default value for 
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this resource is equal to the space between icons as they are placed on the screen (this 
space is based on maximizing the number of icons in each row and column). 

interactivePlacanent (class InteractivePlacement) 

This resource controls the initial placement of new windows on the screen. If the value is 
True, the pointer shape changes before a new window is placed on the screen to indicate 
to the user that a position should be selected for the upper-left hand comer of the win- 
dow. If the value is False, windows are placed according to the initial window 
configuration attributes. The default value of this resource is False. 

keyBindings (class KeyBindings) 

This resource identifies the set of key bindings for window management functions. If 
specified these key bindings replace the built-in default bindings. The named set of key 
bindings is specified in mwm resource description file. The default value for this 
resource is "DefaultKeyBindings". 

keyboardFocusPoIicy (class KeyboardFocusPolicy) 

If set to pointer, the keyboard focus policy is to have the keyboard focus set to the client 
window that contains the pointer (the pointer could also be in the client window decora- 
tion that mwm adds). If set to explicit, the policy is to have the keyboard focus set to a 
client window when the user presses button 1 with the pointer on the client window or 
any part of the associated mwm decoration. The default value for this resource is expli- 
cit. 

limitResize (class LimitResize) 

If this resource is True, the user is not allowed to resize a window to greater than the 
maximum size. The default value for this resource is True. 

lowerOnlconify (class LowerOnlconify) 

If this resource is given the default value of True, a window's icon appears on the bottom 
of the window stack when the window is minimized (iconified). A value of False places 
the icon in the stacking order at the same place as its associated window. The default 
value of this resource is True. 

maximumM aximumSize (class M aximumMaximumSize) 

This resource is used to limit the maximum size of a client window as set by the user or 
client. The resource value is widthsheight (for example, 1024x1024) where the width and 
height are in pixels. The default value of this resource is twice the screen width and 
height. 

moveThreshold (class MoveThreshold) 

This resource is used to control the sensitivity of dragging operations that move windows 
and icons. The value of this resource is the number of pixels that the locator is moved 
with a button down before the move operation is initiated. This is used to prevent 
window/icon movement when you click or double-click and there is unintentional 
pointer movement with the button down. The default value of this resource is 4 (pixels). 

multiscreen (class MultiScreen) 

This resource, if True, causes mwm to manage all the screens on the display. If False, 
mwm manages only a single screen. The default value is False. 

passButtons (class PassButtons) 

This resource indicates whether or not button press events are passed to clients after 
they are used to do a window manager function in the client context. If the resource 
value is False, the button press is not passed to the client. If the value is True, the button 
press is passed to the client window. The window manager function is done in either 
case. The default value for this resource is False. 

passSelectButton (class PassSelectButton) 

This resource indicates whether or not to pass the select button press events to clients 
after they are used to do a window manager function in the client context. If the 
resource value is False, then the button press will not be passed to the client. If the value 
is True, the button press is passed to the client window. The window manager function 
is done in either case. The default value for this resource is True. 
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positionlsFrame (class PositionlsFrame) 

This resource indicates how client window position information (fix>m the 
WM_NORMAL_HINTS property and from configuration requests) is to be interpreted. 
If the resource value is True, the information is interpreted as the position of the MWM 
client window frame. If the value is False, it is interpreted as being the position of the 
client area of the window. The default value of this resource is True. 

positionOnScreen (class PositionOnScreen) 

This resource is used to indicate that windows should initially be placed (if possible) so 
that they are not clipped by the edge of the screen (if the resource value is True). If a 
window is larger than the size of the screen, at least the upper left comer of the window 
is on-screen. If the resource value is False, windows are placed in the requested position 
even if totally oflf-screen. The default value of this resource is True. 

quitTimeout (class QuitTimeout) 

This resource specifies the amount of time (in milliseconds) that mwin will wait for a 
client to update the WM_COMMAND property after ntwm has sent the 
WM_SAVE_YOURSELF message. This protocol is used only for those clients that have 
a WMSAVEYOURSELF atom and no WMDELETE WINDOW atom in the 
WMPROTOCOLS client window property. The default value of this resource is 1000 
(ms). (Refer to the f.kill function for additional information.) 

raiseKeyFocus (class RaiseKeyFocus) 

This resource is available only when the keyboard input focus policy is explicit. When set 
to True, this resource specifies that a window raised by means of the 
f.normalize_and_raise function also receives the input focus. The default value of this 
resource is False. 

resizeBorderWidth (class ResizeBorderWidth) 

This resource specifies the width (in pixels) of a client window frame border with resize 
handles. The specified border width includes the 3-D shadows. The default is 10 (pix- 
els). 

resizeCursors (class ResizeCursors) 

This is used to indicate whether the resize cursors are always displayed when the pointer 
is in the window size border, shown. The default value is True. 

screens (class Screens) 

This resource specifies the resource names to use for the screens mananged by mwm. If 
mwm is managing a single screen, only the first name in the list is used. If mwm is 
managing multiple screens, the names are assigned to the screens in order, starting with 
screen 0. Screen gets the first name, screen 1 the second name, and so on. The default 
screen names are 0, 1, and so on. 

showFeedback (class ShowFeedback) 

This resource controls when feedback information is displayed. It controls both window 
position and size feedback during move or resize operations and initial client placement. 
It also controls window manager message and dialog boxes. 

The value for this resource is a list of names of the feedback options to be enabled or 
disabled; the names must be separated by a space. If an option is preceded by a minus 
sign, that option is excluded from the list. The sifft of the first item in the list determines 
the initial set of options. If the sign of the first option is minus, mwm assumes all 
options are present and starts subtracting from that set. If the sign of the first decoration 
is plus (or not specified), mwm starts with no options and builds up a list from the 
resource. 

The names of the feedback options are shown below: 
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Name 


Description 


all 


Show all feedback (Default value) 


behavior 


Confirm behavior switch 


kill 


Confirm on receipt of KILL signal 


move 


Show position during move 


none 


Show no feedback 


placement 


Show position and size during initial placement 


quit 


Confirm quitting MWM 


resize 


Show size during resize 


restart 


Confirm MWM restart 



The following command line illustrates the syntax for showFeedback: 

Mwm^showFeedback: placement resize behavior restart 

This resource specification provides feedback for initial client placement and resize, and 
enables the dialog boxes to confirm the restart and set behavior functions. It disables 
feedback for the move function. 

The default value for this resource is all. 

startupKeyFocus (class StartupKeyFocus) 

This resource is available only when the keyboard input focus policy is explicit When 
given the default value of True, a window gets the keyboard input focus when the window 
is mapped (that is, initially managed by the window manager). 

transientDecoration (class TVansientDecoration) 

This controls the amount of decoration that Mwm puts on transient windows. The 
decoration specification is exactly the same as for the clientDecoration (client specific) 
resource. Transient windows are identified by the WM_TRANSIENT_FOR property 
which is added by the client to indicate a relatively temporary window. The default value 
for this resource is menu title (that is, transient windows have resize borders and a 
titlebar with a window menu button). 

transientFXinctions (class TVansientRinctions) 

This resource is used to indicate which window management functions are applicable (or 
not applicable) to transient windows. The function specification is exactly the same as 
for the clientF^inctions (client specific) resource. The default value for this resource is 
-minimize -maximize. 

uselconBox (class UselconBox) 

If this resource is given a value of True, icons are placed in an icon box. When an icon 
box is not used, the icons are placed on the root window (default value). 

wMenuButtonClick (class WMenuButtonCIick) 

This resource indicates whether a click of the mouse when the pointer is over the win- 
dow menu button posts and leaves posted the window menu. If the value given this 
resource is True, the menu remains posted. True is the default value for this resource. 

wMenuButtonCUck2 (class WMenuButtonClick2) 

When this resource is given the default value of True, a double-click action on the win- 
dow menu button does an f.kill function. 

Client Specific Resources 

The syntax for specifying client specific resources is 
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Mwm*client_name_or_class*resourceJd 

For example, ]VIwm*mtenn*windowMenu is used to specify the window menu to be used with 
mterm clients. 

The syntax for specifying client specific resources for all classes of clients is 

Mwm*resourceJd 

Specific client specifications take precedence over the specifications for all clients. For example, 
Mwm*windowMenu is used to specify the window menu to be used for all classes of clients that 
don't have a window menu specified. 

The syntax for specifying resource values for windows that have an unknown name and class (that 
is, windows that do not have a WM_CLASS property associated with them) is 

Mwm*de{aults*resourceJd 

For example, Mwm*defoults'i'iconImage is used to specify the icon image to be used for windows 
that have an unknown name and class. 

The following client specific resources can be specified: 



Client Specific Resources | 


Name 


Class 


Value Type 


Default 


clientDecoration 


ClientDecoration 


string 


all 


clientFunctions 


ClientFunctions 


string 


all 


focusAutoRaise 


FocusAutoRaise 


T/F 


vanes 


iconlmage 


Iconlmage 


pathname 


(image) 


iconlmageBackground 


Background 


color 


icon 
background 


iconlmageBottomShadowColor 


Foreground 


color 


icon bottom 
shadow 


iconlmageBottomShadowPixmap 


BottomShadow- 
Pixmap 


color 


icon bottom 
shadow pixmap 


iconlmageForeground 


Foreground 


color 


vanes 


iconlmageTopShadowColor 


Background 


color 


icon top 
shadow color 


iconlmageTopShadowPixmap 


TopShadow- 
Pixmap 


color 


icon top 
shadow pixmap 


matteBackground 


Background 


color 


background 


matteBottomShadowColor 


Foreground 


color 


bottom 
shadow color 


matteBottomShadowPixmap 


BottomShadow- 
Pixmap 


color 


bottom shadow 
pixmap 


mattcForeground 


Foreground 


color 


foreground 


matteTopShadowColor 


Background 


color 


top shadow 
color 


matteTopShadowPixmap 


TopShadow- 
Pixmap 


color 


top shadow 
pixmap 


matteWidth 


MatteWidth 


pixels 
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maximumClientSize 


MaximumClientSize 


wxh 


fill the 
screen 


useClientlcon 


UseClientlcon 


T/F 


F 


windowMenu 


WindowMenu 


string 


"DefaultWindowMenu" 



clientDecoration (class ClientDecoration) 

This resource controls the amount of window frame decoration. The resource is 
specified as a list of decorations to specify their inclusion in the frame. If a decoration is 
preceded by a minus sign, that decoration is excluded from the frame. The sign of the 
first item in the list determines the initial amount of decoration. If the sign of the first 
decoration is minus, mwm assumes all decorations are present and starts subtracting 
from that set. If the sign of the first decoration is plus (or not specified), then mwm 
starts with no decoration and builds up a list from the resource. 



Name 


Description 


all 


Include all decorations (default value) 


border 


Window border 


maximize 


Maximize button (includes title bar) 


mmimize 


Minimize button (includes title bar) 


none 


No decorations 


resizeh 


Border resize handles (includes border) 


menu 


Window menu button (includes title bar) 


title 


Title bar (includes border) 



Examples: 

Mwm*XC]ock.clientDecoration: -resizeh -maximize This removes the resize handles 
and maximize button from XClock windows. 

Mwm*XClock.clientDecoration: menu minimize border This does the same thing as 
above. Note that either menu or minimize implies title. 

cIientI\inctions (class ClientRinctions ) 

This resource is used to indicate which mwm functions are applicable (or not applicable) 
to the client window. The value for the resource is a list of functions. If the first function 
in the list has a minus sign in front of it, then mwm starts with all functions and subtracts 
from that set. If the first function in the list has a plus sign in front of it, then mwm starts 
with no functions and builds up a list. Each function in the list must be preceded by the 
appropriate plus or minus sign and separated from the next function by a space. The 
table below lists the functions available for this resource: 
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Name 


Description 


all 


Include all functions (default value) 


none 


No functions 


resize 


f.resize 


move 


f.move 


minimize 


f.minimize 


maximize 


f.maximize 


close 


f.kill 



focusAutoRaise (class FocusAutoRaise) 

When the value of this resource is True, clients are raised when they get the keyboard 
input focus. If the value is False, the stacking of windows on the display is not changed 
when a window gets the keyboard input focus. The default value is True when the key- 
boardFocusPolicy is explicit and False when the keyboardFocusPolicy is pointer. 

iconlmage (class Iconlmage) 

This resource can be used to specify an icon image for a client (for example, 
"Mwm*myclock*iconImage"). The resource value is a pathname for a bitmap file. The 
value of the (client specific) useClientlcon resource is used to determine whether or not 
user supplied icon images are used instead of client supplied icon images. The default 
value is to display a built-in window manager icon image. 

iconlmageBackground (class Background) 

This resource specifies the background color of the icon image that is displayed in the 
image part of an icon. The default value of this resource is the icon background color 
(that is, specified by "Mwm*background or Mwm*icon*background). 

iconlmageBottomShadowCoIor (class For^round) 

This resource specifies the bottom shadow color of the icon image that is displayed in 
the image part of an icon. The default value of this resource is the icon bottom shadow 
color (that is, specified by Mwm*icon*bottomShadowColor). 

iconlmageBottomShadowPixmap (class BottomShadowPixmap) 

This resource specifies the bottom shadow Pixmap of the icon image that is displayed in 
the image part of an icon. The default value of this resource is the icon bottom shadow 
Pixmap (i.e., specified by Mwm*icon*bottomShadowPixmap). 

iconlmageForeground (class Foreground) 

This resource specifies the foreground color of the icon image that is displayed in the 
image part of an icon. The default value of this resource varies depending on the icon 
background. 

iconlmageTopShadowCoIor (class Bacl^round) 

This resource specifies the top shadow color of the icon image that is displayed in the 
image part of an icon. The default value of this resource is the icon top shadow color 
(that is, specified by Mwm*icon*topShadowColor). 

iconlmageTopShadowPixmap (class TopShadowPixmap) 

This resource specifies the top shadow Pixmap of the icon image that is displayed in the 
image part of an icon. The default value of this resource is the icon top shadow pixmap 
(that is, specified by Mwm*icon*topShadowPixmap). 

matteBackground (class Background) 

This resource specifies the background color of the matte, when matteV^dth is positive. 
The default value of this resource is the client background color (that is, specified by 
"Mwm*background or Mwm*client*background). 
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matteBottomShadowColor (class Foreground) 

This resource specifies the bottom shadow color of the matte, when matteWidth is posi- 
tive. The default value of this resource is the client bottom shadow color (that is, 
specified by "Mwm*bottomShadowColor or Mwm*client*bottomShadowColor). 

matteBottomShadowPixmap (class BottomShadowPixmap) 

This resource specifies the bottom shadow Pixmap of the matte, when matteWidth is 
positive. The default value of this resource is the client bottom shadow pixmap (that is, 
specified by "Mwm*bottomShadowPixmap or Mwm*client*bottomShadowPixmap). 

matteForeground (class For^round) 

This resource specifies the foreground color of the matte, when matteWidth is positive. 
The default value of this resource is the client foreground color (that is, specified by 
"Mwm'foreground or Mwm*client*foreground). 

matteTopShadowColor (class Baclcground) 

This resource specifies the top shadow color of the matte, when matteWidth is positive. 
The default value of this resource is the client top shadow color (that is, specified by 
"Mwm*topShadowColor or Mwm*client*topShadowColor). 

matteTopShadowPixmap (class TopShadowPixmap) 

This resource specifies the top shadow pixmap of the matte, when matte^dth is posi- 
tive. The default value of this resource is the client top shadow pixmap (that is, specified 
by "Mwm*topShadowPixmap or Mwm*client*topShadowPixmap). 

matteWidth (class MatteWidth) 

This resource specifies the width of the optional matte. The default value is 0, which 
effectively disables the matte. 

maximumClientSize (class MaximumClientSize) 

This is a size specification that indicates the client size to be used when an application is 
maximized. The resource value is specified as widthsheight. The width and height are 
interpreted in the units that the client uses (for example, for terminal emulators this is 
generally characters). If this resource is not specified, the maximum size from the 
WM_NORMAL_HINTS property is used if set. Otherwise the default value is the size 
where the client window with window management borders fills the screen. When the 
maximum client size is not determined by the maximumClientSize resource, the max- 
imumMaximumSize resource value is used as a constraint on the maximum size. 

useClientlcon (class UseClientlcon) 

If the value given for this resource is True, a client supplied icon image takes precedence 
over a user supplied icon image. The default value is False, giving the user supplied icon 
image higher precedence than the client supplied icon image. 

windowMenu (class WindowMenu) 

This resource indicates the name of the menu pane that is posted when the window 
menu is popped up (usually by pressing button 1 on the window menu button on the 
client window frame). Menu panes are specified in the MWM resource description file. 
Window menus can be customized on a client class basis by specifying resources of the 
form Mwm*c/ienf_name_or_c/ay5*windowMenu (See "Mwm Resource Description File 
Syntax"). The default value of this resource is "DefaultWindowMenu". 

Resource Description File 

The MWM resource description file is a supplementary resource file that contains resource 
descriptions that are referred to by entries in the defaults files (.Xdefaults, app-defaults/Mwm). It 
contains descriptions of resources that are to be used by mwm, and that cannot be easily encoded 
in the defaults files (a bitmap file is an analogous type of resource description file). A particular 
mwm resource description file can be selected using the configFile resource. 

The following types of resources can be described in the mwm resource description ffle: 
Buttons Window manager functions can be bound (associated) with button events. 
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Keys Window manager functions can be bound (associated) with key press events. 

Menus Menu panes can be used for the window menu and other menus posted with key 

bindings and button bindings. 

mwm Resource Description File Syntax 

The mwm resource description file is a standard text file that contains items of information 
separated by blanks, tabs, and new-line characters. Blank lines are ignored. Items or characters 
can be quoted to avoid special interpretation (for example, the comment character can be quoted 
to prevent it from being interpreted as the comment character). A quoted item can be contained 
in double quotes ("). Single characters can be quoted by preceding them by the back-slash charac- 
ter (\). All text from an unquoted # to the end of the line is regarded as a comment and is not 
interpreted as part of a resource description. If ! is the first character in a line, the line is 
regarded as a comment. Window manager functions can be accessed with button and key bind- 
ings, and with window manager menus. Functions are indicated as part of the specifications for 
button and key binding sets, and menu panes. The function specification has the following syntax: 

function = function juane [function _args] 

function jiame = window manager function 
function _ar^ = {quoted Jtem \ unquoted jtem} 

The following functions are supported. If a function is specified that isn't one of the supported 
functions then it is interpreted by mwm as f nop. 

f.beep This function causes a beep. 

f.circIe_down [icon | window] 

This function causes the window or icon that is on the top of the window stack to be put 
on the bottom of the window stack (so that it no longer obscures any other window or 
icon). This function affects only those windows and icons that obscure other windows and 
icons, or that are obscured by other windows and icons. Secondary windows (that is, tran- 
sient windows) are restacked with their associated primary window. Secondary windows 
always stay on top of the associated primary window and there can be no other primary 
windows between the secondary windows and their primary window. If an icon function 
argument is specified, the function applies only to icons. If a window function argument is 
specified, the function applies only to windows. 

flcircle_up [icon | window] 

This function raises the window or icon on the bottom of the window stack (so that it is 
not obscured by any other windows). This function affects only those windows and icons 
that obscure other windows and icons, or that are obscured by other windows and icons. 
Secondary windows (that is, transient windows) are restacked with their associated pri- 
mary window. If an icon function argument is specified, the function applies only to icons. 
If an window function argument is specified, the function applies only to windows. 

f.exec or ! 

This function causes command to be executed (using the value of the MWMSHELL 
environment variable if it is set, otherwise the value of the SHELL environment variable if 
it is set, otherwise /bin/sh). The ! notation can be used in place of the flexec function 
name. 

f.focus_coIor 

This function sets the colormap focus to a client window. If this function is done in a root 
context, the default colormap (setup by the X Window System for the screen where MWM 
is running) is installed and there is no specific client window colormap focus. This func- 
tion is treated asf.nop if colormapFocusPolicy is not ejqilicit. 

f.focus_k^ 

~ This function sets the keyboard input focus to a client window or icon. This function is 
treated as f.nop if keyboardPocusPolicy is not explicit or the function is executed in a root 
context. 
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tkill This function is used to terminate a client. If the WMDELETEWINDOW protocol is 
set up, the client is sent a client message event indicating that the client window should be 
deleted. If the WMSAVEYOURSELF protocol is set up and the 
WM_DELETE_WINDOW protocol is not set up, the client is sent a client message event 
indicating that the client needs to prepare to be terminated. If the client does not have 
the WMDELETEWINDOW or WMSAVEYOURSELF protocol set up, this func- 
tion causes a client's X connection to be terminated (usually resulting in termination of 
the client). Refer to the description of the quitTimeout resource and the 
WMPROTOCOLS property. 

Slower [-client] 

This function lowers a client window to the bottom of the window stack (where it obscures 
no other window). Secondary windows (that is, transient windows) are restacked with 
their associated primary window. The client argument indicates the name or class of a 
client to lower. If the client argument is not specified, the context that the function was 
invoked in indicates the window or icon to lower. 

tmaximize 

This function causes a client window to be displayed with its maximum size. 

f.menu This function associates a cascading (pull-right) menu with a menu pane entry or a menu 
with a button or key binding. The menujtame function argument identifies the menu to 
be used. 

f.Tninimize 

This function causes a client window to be minimized (iconified). When a window is 
minimized when no icon box is used, its icon is placed on the bottom of the window stack 
(so that it obscures no other window). If an icon box is used, the client's icon changes to 
its iconified form inside the icon box. Secondary windows (that is, transient windows) are 
minimized with their associated primary window. There is only one icon for a primary 
window and all its secondary windows. 

tmove This function causes a client window to be interactively moved. 

f.next_cmap 

This function installs the next colormap in the list of colormaps for the window with the 
colormap focus. 

£next_key [icon | window | transient] 

This function sets the keyboard input focus to the next window/icon in the set of 
windows/icons managed by the window manager (the ordering of this set is based on the 
stacking of windows on the screen). This function is treated as f. nop if keyboardFocusPol- 
icy is not explicit. The keyboard input focus is moved only to windows that do not have an 
associated secondary window that is application modal. If the transient argument is 
specified, transient (secondary) windows are traversed (otherwise, if only window is 
specified, traversal is done only to the last focused window in a transient group). If an 
icon function argument is specified, the function applies only to icons. If a window func- 
tion argument is specified, the function applies only to windows. 

tnop This function does nothing. 

(normalize 

This function causes a client window to be displayed with its normal size. Secondary win- 
dows (that is, transient windows) are placed in their normal state along with their associ- 
ated primary window. 

f.nonnalize and raise 

This function causes the corresponding client window to be displayed with its normal size 
and raised to the top of the window stack. Secondary windows (i.e., transient windows) 
are placed in their normal state along with their associated primary window. 

f.pack_icons 

This function is used to relayout icons (based on the layout policy being used) on the root 
window or in the icon box. In general this causes icons to be "packed" into the icon grid. 
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flpass_keys 

This function is used to enable/disable (toggle) processing of key bindings for window 
manager functions. When it disables key binding processing all keys are passed on to the 
window with the keyboard input focus and no window manager functions are invoked. If 
the f.passjceys function is invoked with a key binding to disable key-binding processing, 
the same key binding can be used to enable key-binding processing. 

Lpost wmenu 

This function is used to post the window menu. If a key is used to post the window menu 
and a window menu button is present, the window menu is automatically placed with its 
top-left comer at the bottom-left comer of the window menu button for the client win- 
dow. If no window menu button is present, the window menu is placed at the top-left 
comer of the client window. 

f.prev_cmap 

This function installs the previous colormap in the list of colormaps for the window with 
the colormap focus. 

tprev key [icon | window | transient] 

This function sets the keyboard input focus to the previous window/icon in the set of 
windows/icons managed by the window manager (the ordering of this set is based on the 
stacking of windows on the screen). This function is treated as f. nop if keyboardFocusPol- 
icy is not explicit. The keyboard input focus is moved only to windows that do not have an 
associated secondary window that is application modal. If the transient argument is 
specified, transient (secondary) windows are traversed (otherwise, if only window is 
specified, traversal is done only to the last focused window in a transient group). If an 
icon function argument is specified, the function applies only to icons. If an window func- 
tion argument is specified, the function applies only to windows. 

f.quit_mwm 

This function terminates mwm (but NOT the X window system). 

Praise {-client] 

This function raises a client window to the top of the window stack (where it is obscured 
by no other window). Secondary windows (that is, transient windows) are restacked with 
their associated primary window. The client argument indicates the name or class of a 
client to raise. If the client argument is not specified, the context that the function was 
invoked in indicates the window or icon to raise. 

f.raise_lower 

This function raises a client window to the top of the window stack if it is partially 
obscured by another window, otherwise it lowers the window to the bottom of the window 
stack. Secondary windows (that is, transient windows) are restacked with their associated 
primary window. 

f.refresh 

This function causes all windows to be redrawn. 

f.refresh_win 

This function causes a client window to be redrawn. 

f.resize This function causes a client window to be interactively resized. 

f.restart 

This function causes mwm to be restarted (effectively terminated and re-executed). 

f.send_msg message jtumber 

This function sends a client message of the type _MOTIF_WM_MESSAGES with the 
message Jype indicated by the message jtumber function argument. The client message is 
sent only if message jtumber is included in the client's _MOTIF_WM_MESSAGES pro- 
perty. A menu item label is grayed out if the menu item is used to do f.sendjnsg of a 
message that is not included in the client's _MOTIF_WM_MESSAGES property. 

f.separator 

This function causes a menu separator to be put in the menu pane at the specified 
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location (the label is ignored). 

flset behavior 

This function causes the window manager to restart with the default behavior (if a custom 
behavior is configured) or revert to the custom behavior. By default this is bound to 
Shift Ctrl Meta <Key>!. 

(title This function inserts a title in the menu pane at the specified location. 

Each function may be constrained as to which resource types can specify the function (for exam- 
ple, menu pane) and also what context the function can be used in (for example, the function is 
done to the selected client window). Function contexts are 

root No client window or icon has been selected as an object for the function. 

window A client window has been selected as an object for the function. This includes 

the window's title bar and frame. Some functions are applied only when the win- 
dow is in its normalized state (for example, f.maximize) or its maximized state 
(for example, f.normalize). 

icon An icon has been selected as an object for the function. 

If a function's context has been specified as icon | window and the function is invoked in an icon 
box, the function applies to the icon box, not to the icons inside. 

If a function is specified in a type of resource where it is not supported or is invoked in a context 
that does not apply, the functibn is treated as f.nop. The following table indicates the resource 
types and function contexts in which window manager functions apply. 
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Function 


Contexts 


Resources 


f.beep 


root, icon, window 


button, key, menu 


f.circle down 


root, icon, window 


button, key, menu 


f.circle_up 


root, icon, window 


button, key, menu 


f.exec 


root, icon, window 


button, key, menu 


f.focus color 


root, icon, window 


button, key, menu 


f.focus key 


root, icon, window 


button, key, menu 


f.kill 


icon, window 


button, key, menu 


f.lower 


root, icon, window 


button, key, menu 


f.maximize 


icon, window(normal) 


button, key, menu 


f.menu 


root, icon, window 


button, key, menu 


f.minimize 


window 


button, key, menu 


f.move 


icon, window 


button, key, menu 


f.next cmap 


root, icon, window 


button, key, menu 


f.next key 


root, icon, window 


button, key, menu 


f.nop 


root, icon, window 


button, key, menu 


f.normalize 


icon, window(maximized) 


button, key, menu 


f.normalize and raise 


icon, window 


button, key, menu 


f.pack icons 


root, icon, window 


button, key, menu 


f.passkeys 


root, icon, window 


button, key, menu 


f.post wmenu 


root, icon, window 


button, key 


f.prev_cmap 


root, icon, window 


button, key, menu 


f.prev_key 


root, icon, window 


button, key, menu 


f.quit mwm 


root 


button, key, menu 


f.raise 


root, icon, window 


button, key, menu 


f.raise lower 


icon, window 


button, key, menu 


f.refresh 


root, icon, window 


button, key, menu 


f.refresh win 


window 


button, key, menu 


f.resize 


window 


button, key, menu 


f.restart 


root 


button, key, menu 


f.send msg 


icon, window 


button, key, menu 


f.separator 


root, icon, window 


menu 


f.set behavior 


root, icon, window 


button, key, menu 


f. title 


root, icon, window 


menu 



Window Manager Event Specification 

Events are indicated as part of the specifications for button and key- binding sets, and menu 
panes. 

Button events have the following syntax: 

button = [modifierJist]<button_event_name> 

modifierjist = modifier jtame {modifier jtame} 

All modifiers specified are interpreted as being exclusive (this means that only the specified 
modifiers can be present when the button event occurs). The following table indicates the values 
that can be used for modifier jtame. The [Alt] key is frequently labeled [Extend] or [Meta]. Alt 
and Meta can be used interchangeably in event specification. 
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Modifier 


Description 


Ctrl 


Control Key 


Shift 


Shift Key 


Alt 


Alt/Meta Key 


Meta 


Meta/Alt Key 


Lock 


Lock Key 


Modi 


Modifierl 


Mod2 


Modifier2 


Mod3 


Modifiers 


Mod4 


Modifier4 


Mod5 


Modifiers 



The following table indicates the values that can be used for button_event_name. 



Button 


Description 


BtnlDown 


Button 1 Press 


BtnlUp 


Button 1 Release 


BtnlClick 


Button 1 Press and Release 


BtnlClick2 


Button 1 Double Click 


Btn2E)own 


Button 2 Press 


Btn2Up 


Button 2 Release 


Btn2Click 


Button 2 Press and Release 


Btn2Click2 


Button 2 Double Click 


Btn3Down 


Button 3 Press 


Btn3Up 


Button 3 Release 


Btn3Click 


Button 3 Press and Release 


Btn3Click2 


Button 3 Double Click 


Btn4E)own 


Button 4 Press 


Btn4Up 


Button 4 Release 


Btn4Click 


Button 4 Press and Release 


Btn4Click2 


Button 4 Double Click 


BtnSDown 


Button 5 Press 


BtnSUp 


Button 5 Release 


BtnSClick 


Button 5 Press and Release 


Btn5Click2 


Button 5 Double Click 



Key events that are used by the window manager for menu mnemonics and for binding to window 
manager functions are single key presses; key releases are ignored. Key events have the following 
syntax: 

key = [modifier_list]<Key>key_name 

modifier Jist = modifier jiame {modifier jtame} 

All modifiers specified are interpreted as being exclusive (this means that only the specified 
modifiers can be present when the key event occurs). Modifiers for keys are the same as those 
that apply to buttons. The key name is an XI 1 keysym name. Keysym names can be found in the 
keysymdef.h file (remove the XK_ prefix). 

Button Bindings 

The buttonBindings resource value is the name of a set of button bindings that are used to 
configure window manager behavior. A window manager function can be done when a button 
press occurs with the pointer over a framed client window, an icon or the root window. The con- 
text for indicating where the button press applies is also the context for invoking the window 
manager function when the button press is done (significant for functions that are context sensi- 
tive). 
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The button binding syntax is 

Buttons binding _set_name 
{ 

button context function 
button context function 

button context function 
} 
The syntax for the context specification is 

context = object[\context] 

object = root | icon | window | title | frame | border | app 

The context specification indicates where the pointer must be for the button binding to be 
effective. For example, a context of window indicates that the pointer must be over a client win- 
dow or window management frame for the button binding to be effective. The frame context is for 
the window management frame around a client window (including the border and titlebar), the 
border context is for the border part of the window management frame (not including the 
titlebar), the title context is for the title area of the window management frame, and the app con- 
text is for the application window (not including the window management frame). 

If an /nop function is specified for a button binding, the button binding is not done. 

Key Bindings 

The keyBindings resource value is the name of a set of key bindings that are used to configure 
window manager behavior. A window manager function can be done when a particular key is 
pressed. The context in which the key binding applies is indicated in the key binding specification. 
The valid contexts are the same as those that apply to button bindings. 

The key binding syntax is: 

Keys bindings _set_name 
{ 

key context function 

key context function 

key context function 
} 
U an f.nop function is specified for a key binding, the key binding is not done. If aaf.postjvmenu 
or f.menu function is bound to a key, mwm will automatically use the same key for removing the 
menu from the screen after it has been popped up. 

The context specification syntax is the same as for button bindings. For key bindings, the frame, 
title, border, and app contexts are equivalent to the window context. The context for a key event is 
the window or icon that has the keyboard input focus (root if no window or icon has the keyboard 
input focus). 

Menu Panes 

Menus can be popped up using the fpostjvmenu and fmenu window manager functions. The 
context for window manager functions that are done from a menu is root, icon or window depend- 
ing on how the menu was popped up. In the case of the window menu or menus popped up with a 
key binding, the location of the keyboard input focus indicates the context. For menus popped up 
using a button binding, the context of the button binding is the context of the menu. 
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The menu pane specification syntax is 

Menu menujtame 
{ 

label [mnemonic] [accelerator] function 
label [mnemonic] [accelerator] Junction 

label [mnemonic] [accelerator] Junction 
} 
Each line in the Menu specification identifies the label for a menu item and the function to be 
done if the menu item is selected. Optionally a menu button mnemonic and a menu button key- 
board accelerator maybe specified. Mnemonics are functional only when the menu is posted and 
keyboard traversal applies. 

The label may be a string or a bitmap file. The label specification has the following syntax 

label = text \ bitmap Jile 

bitmap Jile = @file_name 

text = quoted Jtem \ unquoted Jtem 

The string encoding for labels must be compatible with the menu font that is used. Labels are 
greyed out for menu items that do the f.nop function or an invalid function or a function that 
doesn't apply in the current context. 

A mnemonic specification has the following syntax 

mnemonic = _character 

The first matching character in the label is underlined. If there is no matching character in the 
label, no mnemonic is registered with the window manager for that label. Although the character 
must exactly match a character in the label, the mnemonic does not execute if any modifier (such 
as Shift) is pressed with the character key. 

The accelerator specification is a key event specification with the same syntax as is used for key 
bindings to window manager functions. 

Environment 

mwm uses the environment variable HOME specifying the user's home directory. 

mwm uses the environment variable LANG specifying the user's choice of language for the mwm 
message catalog and the mwm resource description file. 

mwm uses the environment variables XFILESEARCHPATH, XUSERFILESEARCHPATH, 
XAPPLRESDIR, XENVIRONMENT, LANG, and HOME in determining search paths for 
resource defaults files. 

mwm reads the $HOME/.motifbind file if it exists to install a virtual key bindings property on the 
root window. For more information on the content of the .motifbind file, see 
VirtualBindings(3X). 

mwm uses the environment variable MWMSHELL (or SHELL, if MWMSHELL is not set) speci- 
fying the shell to use when executing commands via the f. exec function. 

FUes 

/usr/lib/Xll/$LANG/system.mwmrc 

/usr/lib/Xll/system.mwmrc 

/usr/lib/Xll/app-defaults/Mwm 

$HOME/Mwm 

$HOME/.Xdefaults 

$HOME/$LANG/.mwmrc 

$HOME/.mwmrc 

$HOME/.motifbind 
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RELATED INFORMATION 

VeiidorSheIl(3X), VirtualBindings(3X), X(l), and XmInstallImage(3X). 
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NAME 

resize - reset shell parameters to reflect the current size of a window 

SYNOPSIS 

resize [-c | -u] [-h | -x | -s [row col]] 

DESCRIPTION 

Resize prints on its standard output the commands for setting $TERM, $LINES, and $COLUMNS 
for a shell to reflect the current size of its window. The $SHELL environment variable is used to 
determine the shell for which to form the commands. The $TERM environment variable is used 
to determine the escape sequences to be used to determine the window size. Both of these can be 
overridden by command line options. 

Resize is never executed directly, but should be run via eval(V) similar to tset(V) to cause the shell 
to execute the commands. For example, the following functions will reset the environment of the 
current shell for 5/t(l) and ksh(iy. 

xs() { eval 'resize'; } 
xrs() { eval 'resize -s $@'; } 

An equivalent for csh(l) is: 

alias xs 'set noglob; eval ^ resize^ ' 
alias xrs 'set noglob; eval ^resize -s \!\* 

OPTIONS 

The resize program accepts the following options listed below: 

-c This option indicates that resize should format its commands for csh(V). 

-« This option indicates that resize should format its commands for sh{X) or ksh(V). 

-h This option indicates that resize should use Hewlett Packard terminal escape sequences 

to obtain the terminal's new window size. 

-X This option indicates that resize should use VT102 escape sequences to obtain the 

terminal's new window size. 

-s [row col] 

This option indicates that resize should use Sun escape sequences to obtain the terminal's 
new window size. In this mode of operation, a new row and column size may be 
specified on the command line. 

FILES 

$HOME/.profile •^^(1) and kshiV) user's functions for resize. 

$HOME/.cshrc csh{\') user's alias for resize. 

NOTES 

"-s" must be the last option on the command line when specified. 

There should be some global notion of display size; termcap and terminfo need to be rethought in 
the context of window systems. 

ORIGINS 

MIT Distribution 

SEE ALSO 

sh(l), ksh(l), csh(l), eval(l), hpterm(l), tset(l), xterm(l) 
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NAME 

rgb - X Window System color database creator. 

SYNOPSIS 

rgb ^filename] [<input filename] 

DESCRIPTION 

rgb creates a data base used by the X window system server for its colors. Stdin is used as its input 
and must be in the format of: 

0-255 0-255 0-255 colomame 

For example: 

black 

128 green 

255 255 255 white 

tgb stands for red-green-ilue. Each element can have no intensity (0) to full intensity (255). How 
the elements are combined determines the actual color. The name given to the color can be 
descriptive or fanciful. 

In other words, the sequence: 

128 

can be given the name 'blue' or 'unicorn blue'. There can also be two (or more) entries with the 
same element numbers or names. 

ARGUMENTS 

filename If filename is given, rgb produces two files; filename.dir and filename.pag. Otherwise 
the default filename is /usr/lib/Xll/rgb. 

ORIGIN 

MIT Distribution 

SEE ALSO 

X(l) 
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NAME 

sb2xwd - translate Starbase bitmap to xwd bitmap format 

SYNOPSIS 

sb2xwd 

DESCRIPTION 

This command translates a bitmap file created by one of the Starbase bitmap-to-file procedures 
into an XWD format file. The XWD format is defined by the xwdQ) and xwud(l) X window dump 
utility programs. The Starbase bitmap file format is described in bitinapfile(4). Translation is 
done from standard input to standard output. 

Starbase bitmaps created in pixel-major format will be translated into ZPixmap format xwd bit- 
maps. Plane-major full-depth Starbase bitmaps are translated mio XYPixmap format xwd bitmaps. 

XWD bitmaps produced by sb2xwd will be of the DirectColor visual class if the Starbase bitmap's 
colormap mode is CMAP_FULL. Other multiplane Starbase bitmaps having colormap modes of 
CMAPNORMAL or CMAP MONOTONIC will result in PseudoColor XWD bitmaps. Single 
plane Starbase bitmaps are converted to GreyScale XWD bitmaps. 

OPTIONS 

none 

EXAMPLES 

sb2xwd < sbfile > xwdfile 

Translates the Starbase image in sbfile to XWD format and places the result in xwdfile. 

sb2xwd < sbimage | xwud 

Translates the image in sbimage, piping the results to xwud for display. 

RESTRICTIONS 

sb2xwd accepts only full-depth Starbase bitmaps. 

Starbase bitmaps must be 1-8, 12, or 24 planes deep. Bitmaps of depth 1-8 must have either 
CMAPNORMAL or CMAPMONOTONIC colormap modes. Bitmaps of depths 12 or 24 must 
have the CMAP_FULL colormap mode. 

A 12 plane bitmap must be stored in three banks and have a display enable mask of OxOF or OxFO. 

ORIGIN 

Hewlett-Packard GTD 

SEE ALSO 

xwd(l), xwud(l), bitmapfile(4). 

Starbase Graphics Techniques, HP-UX Concepts and Tutorials, chapters on "Color" and "Storing 
and Printing Images". 
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NAME 

stconv - Utility to convert scalable type symbol set map formats 

SYNOPSIS 

Stconv infile [-hmq] [-d mapdir] [-to ACG\HPMSL\other\ 

DESCRIPTION 

The stconv utility is used to convert scalable typeface symbol set maps (.sym files) from one sym- 
bol list numbering format to another. The installation default symbol sets map their respective 
symbols into appropriate HP Master Symbol List character codes (the default format provided in 
•ifo typeface libraries). Since it is possible, however, to use stload(lM) to generate libraries that 
use some other symbol list numbering (such as native Agfa Compugraphic ACG numbering), 
stconv provides a way to modify existing .sym files to map characters to non-MSL numbers. 

A symbol list assigns a unique numeric value to each individual character in the global collection 
of characters available from a specific typeface manufacturer. The specific numbering scheme 
used is usually unique to that vendor, and typically identifies hundreds or even thousands of char- 
acters. A symbol set (or character set) is generally a particular subset of characters taken from this 
master collection, with each character being assigned another unique code in accordance with the 
some specific registry/encoding scheme (such as IS08859 Latin-1 or HP Roman-8). In this 
respect, the .sym files used by the HP Scalable Type subsystem are actually symbol set maps, 
equating all the character codes comprising a specific character set registry/encoding to the 
corresponding character numbers of a particular typeface vendor's symbol list. 

Intellifont format scalable typeface libraries are commercially available with HP Master Symbol 
List character numbering (HPMSL) in products obtained from the HP MasteiType Library, and 
with Agfa Compugraphic symbol list numbering (ACG) for products from the Agfa Typeface 
Library. 

OPTIONS 

There are several command line parameters which are described below. 

infile Required name of the .sym file to be converted. 

-d mapdir 

Specifies the name of the directory containing the symbol list conversion map (see 
below). This directory should contain the file ACG-HPMSL, plus any optional addi- 
tional symbol list maps. If unspecified, stconv looks for an appropriate map in 
/usr/lib/Xll/fonts/stadmin/ifi)/charsets. The file ACG-HPMSL defines the translation 
between Agfa Compugraphic symbol list numbering and HP Master Symbol List 
numbering. 

-h Requests help. 

-m Requests that stconv list the conversion map. 

-q Requests that stconv should run quietly. 

•to format 

Specifies the new symbol list format. The installation-default symbol sets use HPMSL 
format; to generate a symbol set for native Agfa Compugraphic symbol list character 
codes, you should specify 4o ACG. 

EXAMPLES 

stconv -to ACG roman8.sym >acgr8.sym 

This reads the HPMSL symbol map roman8.sym, and writes the ACG version to 
acgr8.sym via stdout redirection. The new symbol map can subsequently be used to gen- 
erate an HP Roman-8 font from an Agfa Typeface Library product. 

SYMBOL LIST CONVERSION MAPS 

A symbol list conversion map defines the translation of character numbers between two different 
symbol lists. The map is a simple text file contain two columns of character codes: the first 
column is the first format's character code, the second column is the second format's character 
code. Lines that begin with anything other than two distinct values are ignored. The name of the 
conversion must be the names of the two formats concantenated together with a hyphen, with care 
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taken to insure the name before the hyphen reflects the numbering scheme used in the first 
column, and the name after the hyphen reflects the numbering scheme used in the second column. 
A single conversion map file is sufficient for converting a symbol list of either format into a sym- 
bol list of the opposite format. As an example, the first few lines of the file ACG-HPMSL are: 

# ACG-HPMSL 

# First column is ACG number 

# Second column is corresponding HPMSL number 

1 86 

2 81 

3 74 

4 80 



FILES 



Stconv takes input only from the specified file, and always sends output to stdout. 

SEE ALSO 

stlicense(lM), stmkfont(l), stmkdirs(l), stload(lM) 

COPYRIGHT 

(c) Copyright 1990, Hewlett-Packard Company 

See X{1) for a full statement of rights and permissions. 
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NAME 

stlicense - server access control program for X 

SYNOPSIS 

stlicense [-v] [-Q) directory] {-fn typeface | -pr product} [[+-]device ...] 

DESCRIPTION 

The stlicense program is run interactively by the font administrator to give devices access to 
typefaces. Responsibility for maintaining security rests with users root, bin , and the owners of the 
font directories. 

OPTIONS 

Stlicense accepts the command line options described below. 

-tp directory 

The path of directories to search for the specified product or typeface. If several direc- 
tories are specified, they are separated by the colon (":") character. Stlicense will search 
the path until it finds a directory that contains the the specified product or typeface. It 
will use that directory for all of its operations. If no -fp option is specifies, the value of 
environment variable STPATH is used. If neither -fp nor STPATH is present, the default 
path is /usr/lib/Xll/fonts/ifo.st. 

-fn typeface 

The typeface being licensed. It is specified as an XLFD font name. The entire font name 
does not have to be specified. The program will use the first typeface whose name 
matches the name specified. 

•prproduct 

Specifying a product instead of a typeface provides a convenient way to license collec- 
tions of typefaces. Product names are established when typefaces are loaded. Use either 
the -fn or the -pr option, but never both. One of them must be present for license addi- 
tions or removals. 

-V The verbose option controls the number messages returned. By default, stlicense prints 

messages only when a request could not be fulfilled. With the verbose option, status 
messages are printed for all licensing requests. 

-help If this is the only option specified, a brief message listing the valid options to stlicense 
will be printed. 

+ device The device is granted a license to the product or typeface specified. Adding a product 
license to the device means adding licenses to all of the typefaces which comprise the 
product. Typefaces licensed to device STSYSTEM will be available to all devices. 

The device is specified in the form hostidevice. 

The host name is a node on the network. They can be discless nodes, workstations, and 
the like. The device, usually a printer, is attached to the host. The name of the device 
must be a valid file name. Special device DISPLAYS refers to all servers running on the 
host. Special device PRINTERS refers to all printers connected to the host. 

The host defaults to the host on which stlicense is running. 

The device defaults to DISPLAYS. Adding a product license to a device which already 
has a license for the product causes the device's fonts.dir file to be updated with the 
current definition of the product. 

-device The license for specified typeface or product is removed from this device. 

device The licenses for specified typeface or product are displayed. 

nothing If no devices are given, the list of devices that have licenses for the typeface is printed on 
the standard output. 

FILES 

This program updates the device's license files in the licenses subdirectory of the typeface direc- 
tory (*.st). It creates and deletes licensing files as necessary. If files for the device do not exist, it 
creates them. Deleting the last license from a device will cause the device's licensing files to be 
deleted. 
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Hosts have directories in licenses. Devices have directories within their host's directory. Typefaces 
available to the device are stored in fonts.dir. Licenses issued to the device are stored in 
products.dir. 

The typefaces that comprise valid products are specified in the products directory of typeface 
directories (*.st). 

SEE ALSO 

stload (IM), stmkfont(l), stconv(lM), stmkdirs(l) 

COPYRIGHT 

Copyright 1990, Hewlett-Packard Company 

See X(l) for a full statement of rights and permissions. 

AUTHORS 
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NAME 

stload - Utility to load Scalable Type outlines 

SYNOPSIS 

Stload [options] directory\filespec... 

DESCRIPTION 

The stload utility creates scalable typeface libraries (.ifo files) from Agfa Compugraphic Font 
Access and Interchange Standard (CG/FAIS) data. (CG/FAIS format libraries on floppy disk or 
CD-ROM media is the common means of distribution for scalable typeface products that are com- 
patible with the HP Scalable Typeface implementation. It is also is the distribution format used by 
HP Type Director/DOS and the HP MasterType library of scalable typeface floppy disks.) Stload 
also simplifies the installation of new symbol sets and existing .ifo files from an archive repository, 
creates Tagged Font Metric Aim files, and establishes new product entries in the Scalable Typeface 
licensing structure. Stload should generally be run interactively by the system font administrator 
to load new scalable typefaces into a Scalable Typeface directory. 

Several typefaces come bundled with the Scalable Typeface system and are automatically installed 
with the product; additional typefaces may be acquired separately. Since new typefaces are gen- 
erally distributed on MS-DOS ftoppy media, the system administrator may need to use utilities 
such as doscp or cp to transfer the typeface files from the distribution media to a temporary loca- 
tion on the target system. CG/FAIS file naming conventions prohibit multiple CG/FAIS diskettes 
from being copied into a common repository, so you should create a unique directory on the host 
system to contain each CG/FAIS diskette you load. Once all of the CG/FAIS typeface files have 
been loaded onto the target system, stload is used to compile them into .ifo scalable typeface 
libraries and install the libraries in an appropriate typefaces directory. 

Stload does not grant licensed access to newly-installed typefaces. Font administrators must use 
the stlicense utility to give devices access to new typefaces. 

OPTIONS 

There are several command line options which are described below. 

directory \filespec 

This is a required parameter specifying the name of the directory or filespec of the data 
to be loaded. You may specify one or more directories containing the FAIS data 
extracted from a typeface distribution diskette, or one or more repositories containing 
.ifo and/or .sym files, or explicit or wildcarded filespecs of existing and/or .sym files. 

-d mapdir 

Specifies the directory containing the symbol list map required by the 4o format option. 
TTiis directory must contain the file ACG-HPMSL, plus any optional additional symbol 
list maps. If left unspecified, stload assumes the symbol list maps can be found in 
Jusr/lib/Xlllfonts/stadmin/ifo/charsets. 

-dos Specifies that the typeface library should be written as a TypeDirector/DOS .typ file. 
Typefaces libraries written in this format cannot be used by the HP-UX Scalable Type 
subsystem, but have the feature of being expandable ~ you can add new typefaces to an 
existing DOS format library. (See "EXAMPLES" below for more details.) 

•{libname 

Specifies the name of the scalable typeface library into which FAIS data should be 
loaded. Normally, loading from FAIS data generates a separate .ifo or .typ library file 
for each typeface, and each library file's name indicates that particular typeface's ID and 
character complement code. The -f option overrides this automatic naming convention 
and lets you add typefaces into a single library with any arbitrary name. 

-ippath Specifies the name of the base directory under which typefaces, metrics, and products 
directories should be used as the target directories for typeface, metric, and product 
definition files. These directories will be created as necessary if they don't already exist. 
Any attempt to load typeface, metric, and product definition files elsewhere by using the 
-o option will be ignored. (If neither the -fp nor -o options are specified, the default base 
directory is jusr jlih jXll j fonts jifost. See .o below for more option information.) 
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Note that -^ does not affect where .sym files will be loaded. Unless you use the -o 
option to direct them elsewhere, symbol sets will still be installed into 
/usr/lib/Xll/fonts/stadminJifo/charsets. 

-h Requests help. Stioad will print out a command line syntax summary and a list of com- 

mand line switch options. No other processing will take place. 

.id[,id^] 

Identifies one or more specific typefaces to be loaded from CG/FAIS data. Normally, 
stioad installs all of the typefaces it can find, loading each typeface into its own .ifo file. 
If you wish to install only one or two specific faces, you must use this option. (Specific 
typeface numbers can be determined by using stioad -list to examine the contents of the 
PAIS directory; the "Face" column reveals typeface IDs.) 

-link Causes stioad to install files the output directory by making hard links back to the origi- 
nal repository in directory rather than by copying the original files. Note that this works 
only when loading .sym files and pre-existing .ifo files. All .ifo files loaded from PAIS 
data are created as new files in the output directory. 

-list Prints a list of the data located in directory on the standard output device. The directory 
may contain either PAIS data, .ifo typeface libraries, or .sym symbol set files. No other 
processing takes place. 

■opath Specifies the name of the output directory in which to write the final .ifo, .sym, and .tfim 
files. If the directory does not exist, stioad will attempt to create it. If left unspecified, 
these files will be written to the following default output directories: 

write .ifo files to /usr /lib /Xll /fonts /ifo.st/typefaces 

write .sym files to /usr /lib /Xll /fonts /stadmin/ifo /charsets 

write .tftn files to /usr/lib /Xll /fonts /ifo.st/metncs 

-p product-number 

Associates a product number with newly-loaded typefaces (.ifo files). Although this can 
be any arbitrary filename-sized string, it should reflect the product number printed on 
the typeface distribution package and media. The stlicense utility requires this product 
number in order to license loaded typefaces for use with specific devices. Product 
numbers are written into a products directory at the same directory level as the .ifo out- 
put directory. For example, if you specified the -opath option, product numbers will be 
written to path /../products; if you do not specify the any output directory, product 
numbers will be written to files in /usr /lib /Xll /fonts/ if o.st /products. The products 
directory will be automatically created if it does not already exist. 

-sym Causes stioad to install files the output directory by making symbolic links back to the 
original repository in directory rather than by copying the original files. Note that this 
works only for loading .sym files and pre-existing .ifo files. All .ifo files loaded from 
PAIS data are created as new files in the output directory. 

-tftn Causes stioad to update Tagged Font Metric .tfm files in the output directory (or in 
/usr /lib /Xll/ fonts /ifo.st/metrics if no output directory is specified). 

-to format 

Specifies the symbol list that should be used for assigning character ID codes when load- 
ing PAIS data. If left unspecified, character IDs will be assigned in accordance with the 
HP Master Symbol List (HPMSL); to retain Agfa Compugraphic ID numbers, you 
should specify -to ACG. 

-u Specifies that the .dir files should not be updated. Stioad normally automatically uses 

the stmkdirs utility to update the fonts.dir, charsets.dir, and metrics.dir files in the out- 
put directory or directories. 

-V Specifies that stioad should run verbosely. 

EXAMPLES 

stioad -p C2050A#D15 . 

Compiles the CG/FAIS data in the current directory and puts the resulting .ifo files in 
/usr / lib /Xll/ fonts /ifo.st/ typefaces. Existing .ifo files in the current directory will also be 
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copied; existing .sym files will be copied into /usr/lib/Xll /fonts /stadmin/ifo /charsets; 
appropriate .tfm files will be added to /usr/lib/Xll /fonts/ifo.st/metrics. The product 
number required for future licensing of these typefaces by stlicense is C2050A#D15. 
Fonts.dir, cliarsets.dir, and inetrics.dir are updated to reflect the additions. 

stload-o. -dos-fbig3.ifo -92500 times 
stload-o. -dos -fbig3.ifo -93717 courier 
stload -o . -p BIG3 -f big3.ifo -92041 univers 

Compiles three different CG/FAIS typefaces into a single .ifo library. The library must 
be explicitly named to prevent stload from assigning names, and all but the last tj^face 
must be loaded in DOS format to keep the library expandable. The final invokation 
loads the last typeface, converts the complete DOS library into true .ifo format, and 
makes the typefaces licensable via the product name BIGS. 

stload -list /usr/lib/Xll/fonts/ifo.st/typefaces 

Lists all of the typefaces currently contained in /usr/lib/Xll /fonts /ifo.st/lypefaces. 

FILES 

Remember that stload requires write access to the directory that will contain the compiled 
typeface libraries. This implies that only the system font administrator should be able to add 
typefaces to the typeface collection in /usr /lib /XU /fonts /ifo.st/typefaces. The files fonts.dir, 
charsets.dir, and ntetrics.dir will be automatically updated to reflect additions. Typeface licenses 
are not modified. 

SEE ALSO 

stlicense(lM), stmkfont(l), stmkdirs(l), stconv(lM) 

COPYRIGHT 

(c) Copyright 1990, Hewlett-Packard Company 
SeeX(i) for a full statement of rights and permissions. 
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NAME 

stmkdirs - Utility to build Scalable Type ".dir" and ".tfm" files. 

SYNOPSIS 

stmkdirs [options] directory [directory ...] 

DESCRIPTION 

The stmkdirs utility creates the fonts.dir, charsets.dir, and metrics.dir files required by the Scal- 
able Type subsystem. It additionally can be used to construct Tagged Font Metrics .tfin files to 
complement a set of Scalable Typeface outline libraries. Stload, the Scalable Typeface installation 
utility, routinely runs stmkdirs as the final step in the installation of a new typeface. 

OPTIONS 

There are several command line options which are described below. 

directory This specifies the names of one or more directories to be processed. At least one direc- 
tory parameter must be specified. Stmkdirs will create whatever .dir files are needed in a 
directory: if a directory contains bitmapped fonts or font outlines, it will create or update 
fonts.dir, if character set files, cliarsets.dir; if TFM files, metrics.dir. 

-d directory 

Specifies the directory containing default character set (.sym) files and the symbol list 
map (such as ACG-HPMSL) required by the -tfin directory option in order to construct 
TFM files. If left unspecified, stmkdirs assumes the this directory to be 
/usr/ lib /Xll/ fonts /stadmin/ifo/charsets. Character set files will be taken from this 
directory only if none are found in any of the processed directories. 

-si syms The -si switch informs stmkdirs that the font library (.ifo) files being processed contain 
some symbol list other than HP Master Symbol List (HPMSL). This information is 
necessary for generation of correct TFM files. For example, for a font loaded by stload 
with the ACG symbol list, -si ACG should be used in the stmkdirs invocation to ensure 
placing correct information in the TFM files. 

-tfin directory 

The -tfin switch instructs stmkdirs to build Tagged Font Metrics (TFM) files in the 
specified directory. TFM files contain font metrics information used by some applica- 
tions to determine information such as character spacing. Data in the TFM files is 
gleaned from typeface library .ifo files and from character set .sym files; TFM files will 
not be built if stmkdirs does not find the required library and character set files. (If 
stmkdirs does not find character set files in any of the directories it processes, it will use 
the character set files in /usr/lib/Xll/fonts/stadmin/ifo/charsets unless pointed else- 
where via the -d option). 

The default behavior of stmkdirs is to attempt to generate complete fonts.dir, charsets.dir, and 
metrics.dir files in all directories specified. You can cause certain items to not be generated or 
included in the final files by using "-" suppression options. Similarly, to generate only certain 
items, you should use one or more " + " options. 

The command line is processed from left to right, making it possible for you to apply diflferent 
options to different directories all in the same command. To avoid confusing behavior you should 
therefore take care to specify all switch options before specifying directory names. 

Data inclusion and exclusion switches include: 

+c Requests that charsets.dir be generated. 

•c Requests that charsets.dir not be generated. 

+f Requests that fonts.dir be generated and should include scalable typeface libraries as 

well as other bitmap fonts (those normally found by mkfontdir). This is equivalent to 
requesting +mo. 

-f Requests that fonts.dir not be generated. 

+m Requests that fonts.dir be generated and should include bitmap fonts (those normally 
found by mkfontdir). 
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-m Requests that bitmap fonts (those normally found by mkfontdir) be excluded from any 

newly generated fonts.dir. 

+o Requests that fonts.dir be generated and should include 

-o Requests that .ifo scalable typeface libraries be excluded from any newly generated 

fonts.dir. 

+ r Requests that metrics.dir be generated. 

-r Requests that metrics.dir not be generated. 

Additional switches include: 

-b Suppress creation of backup files. Normally, whenever stmkdirs constructs a new 

fonts.dir, cliarsets.dir, or metrics.dir file, any pre-existing old version of that file is 
renamed (to its original name with a tilde """ appended) rather than overwritten. The 
-b option disables this feature. 

-h Print usage information on stdout. 

EXAMPLES 

stmkdirs -tfin /usr/lib/Xll/fonts/ifo.st/metrics /usr/lib/Xll/fonts/ifo.st/typefaces 

Requests that fonts.dir and, if appropriate, charsets.dir files be built in 
/usr I lib/ XI 1/ fonts /ifo. St /typefaces. In addition, the -tfin switch requests that .tfin files 
plus an appropriate metrics.dir file be built in /usr /lib /Xll /fonts /ifo.st /metrics. 

SEE ALSO 

stlicense(lM), stmkfont(l), stload(lM) 

COPYRIGHT 

Copyright 1990, Hewlett-Packard Company 

See X{1) for a full statement of rights and permissions. 
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NAME 

stmkfont - Scalable Typeface font compiler to create X and PCL fonts 

SYNOPSIS 

stmkfont [options] xlfdname 

DESCRIPTION 

The stmkfont utility is a bit-mapped font generator for creating X and PCL fonts from scalable 
typeface data. By specifying desired font characteristics via an X Logical Font Description (XLFD) 
name, the user can instruct stmkfont to generate an almost limitless variety of font flavors from 
one or more Agfa Compugraphic Intellifont typeface libraries. Possible output formats are BDF, 
SNF, and PCL for various HP printers. 

REQUIRED PARAMETERS 

xlfdname 

The last argument on the command line is always assumed to be the required XLFD 
name. The XLFD name is the means by which you specify the typeface, font size, and 
additional treatments for the final font. (See xlfd(3) for information on XLFD construc- 
tion). The XLFD name should begin with a field-delimiter hyphen and specify from one 
to fourteen contiguous fields. If less than 14 fields are given, stmkfont will automatically 
append wildcard fields to fill the name out to fourteen. Stmkfont then attempts to qualify 
the XLFD name by looking for a matching scalable typeface descriptor in fonts.dir, and 
upon finding a one, proceeds to build the font. 

SWITCH OPTIONS 

-^ progname 

Specifies an alternate BDF-to-SNF converter utility to be run in place of the standard 
utility bdftosnf. Affects operation only if the SNF output format is specified. 

-C Output a catalog of typeface/character set combinations. For the given XLFD 

specification, stmkfont will generate a list of fully qualified XLFD names that reflect the 
various typefaces and character sets that could be used to construct a final font. No font 
is generated when this option is used. 

-I Send additional status information to stderr, such as the requested and final XLFD 

names, return status of the underlying stmakefontQ call, and a list of characters that 
either failed font generation or were not in the symbol set. 

-P Send "one-percent progress dots" to stderr. As stmkfont constructs the final font, it will 

output a stream of period characters at regular time intervals. Exactly 100 periods will 
be output; when the 100th dot has been sent, the font is ready. 

-S If one of the PCL output formats is requested, this option causes stmkfont to output to 

stderr the PCL selection string required to select the resulting font on the PCL printer. 

-T Suppress temporary output file. In its normal mode of operation, stmkfont takes time to 

"dribble" ouQiut into a /tmp tempfile, and then quickly "burst" copy the complete 
tempfile to the actual output file or device. While this file re-copy does cause stmkfont 
to take somewhat longer to produce results, it minimizes the amount of time that a 
parent process must spend "listening" to stmkfont's output. If overall speed is more crit- 
ical than time spent actually writing the final output, this switch can be used to bypass the 
tempfile and "dribble" output directly to the final destination. 

-V Requests that a fully qualified XLFD name be sent to stderr without continuing to gen- 

erate final output. 

-b string Specifies command line arguments to be passed to the BDF-to-SNF utility when generat- 
ing an SNF font. Affects operation only if the SNF output format is specified. 

■ctCharsetFile 

-cp CharsetPath 

These options allow you to specify the subdirectory (under one of the database direc- 
tories) and/or filename of a symbol set mapping file. Once stmkfont has determined the 
name of the scalable typeface library it will use, it extracts the filename extension from 
the library's name, and uses it in conjunction with CharsetPath, CharsetFile, and the 
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database directory trees Primary and Alternate to locate an appropriate character set 
map. Stmkfont will look for CharsetFile (or charsets.dir) in several directories, in the fol- 
lowing order: 

1. Primary /TypefaceExtension/CharsetPath 

2. Alternate /TypefaceExtension/CharsetPath 

3. {STPATH}/TypefaceExtension/CharsetPath 

If left unspecified, the default CharsetPath is chars«ts, and the default CharsetFile is 
determined by scanning the above directories for charsets.dir, then using the Charset 
Registry and Charset Encoding properties of the XLFD name to extract from it a charset 
map filename. Note: In the above directory search hierarchy there should normally exist 
only one charsets.dir file. Stmkfont will stop searching when the first charsets.dir is encoun- 
tered. If that charsets.dir does not contain an expropriate registry /encoding to match the 
XLFD name, stmkfont will be unable to generate the requested font. 

In practice, the character sets are usually found in the Alternate directory's CharsetPath 
subdirectory. When this product is installed, for example, the character sets are placed 
in the /usr/lib/Xll/fonts/stadmin/ifo/charsets directory, where stmkfont finds them 
with the default Alternate and CharsetPath values. 

The Alternate directory is also the customary home of the misc/st.dev file used by 
stmkfont to determine PCL printer characteristics. 

Because the Alternate directory is the customary home of many important typeface- 
independent files, it is usually inadvisable to use the -d2 option. 

■Al Primary 

•Al Alternate 

Whenever stmkfont must open a typeface library, a character set map, or a *.dir control 
file, it searches through several directories in a specific order until either the required 
file is found, or the list of search directories are exhausted. These database directories 
and the order in which they are searched are as follows: 

1. Primary (default /usr/lib/Xll/fonts/ifo.st) 

2. Alternate (default /usr/lib/Xll/fonts/stadmin) 

3. {STPATH} (environment variable) 

The -dl and -d2 options let you change the Primary and Alternate database directories. If 
a requested file cannot be found based on either of these two paths, additional places to 
look can be specified by using the STPATH environment variable. 

In practice, typefaces are usually found in the Primary directory, and character sets are 
found in the Alternate directory's CharsetPath directory (see below). 

-dv device 

Specifies the device for which a font is to be made, in the format host-device. If not 
specified or partly specified (host: or .-device), host defaults to the executing machine's 
hostname, and device defaults to PRINTERS or DISPLAYS (depending on the output 
format specified). See stlicense(J) for further information on the format of the device 
parameter. 

•(format 

Specifies the output format for the requested font, which must be one of the following: 
BDF, SNF, or one of the supported PCL printer formats. Output formats currently sup- 
ported are: LJPLUS, LJII, LJ2000, LJIIP, UIII (bitmapped fonts for various models of 
LaserJet), PJXL (bitmapped fonts for the PaintJet XL), and PCLEO (scalable fonts for 
the LaserJet III). Bitmapped fonts reflect any transformations (such as emboldening and 
obliqueing) requested in the xlfdname argument; scalable fonts (PCLEO format) do not. 
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If left unspecified, output format is BDF. If SNF output is requested, stmkfont generates 
BDF and pipes output through the bdftosnf vXiWty. 

-h There is no -h option. For online help, run stmkfont without any parameters. 

•id fonts. dir 

-ns charsets.dir 

-nt typefaces.dir 

These three options allow you to specify alternate names for the three control files that 
may be used by stmkfont. fonts.dir contains a list of typeface library files and the XLFD 
"outline" name descriptions of those typefaces. charsets.dir contains associates charac- 
ter set registry, encoding, and requirements with particular character set map files. 
typefoces.dir assigns "official" names to individual A^a Compugraphic typeface IDs. 

-nv name 

Specifies an alternate environment variable name to use instead of STPATH. 

-o outfile 

This option specifies the output file. Default is stdout. 

-q Run quietly (suppress error messages). 

-V Similar to the -V option, -v requests that a fully qualified XLFD name be sent to stderr 

before stmkfont begins generating glyphs. The string will be terminated with a newline 
character and stderr will be flushed before any glyph output appears. 

-w This option causes all bitmap output data to be suppressed, resulting in only header and 

trailer information being generated. Header metrics will accurately reflect the entire 
font that would have been emitted, but the character count will show zero. 

ENVIRONMENT 
STPATH 

STPATH specifies the last-resort paths to be searched when looking for typeface 
libraries, character set mapping files, and ♦.dir files. Searching STPATH is only con- 
sidered if requested files are not found in the Primary or Alternate paths (normally, 
/usr/lib/Xll/fonts/ifo.st and /usr/Iib/Xll/fonts/stadmin). STPATH has a format 
similar to the PATH variable, consisting of one or more paths concatenated together with 
colons. 

ABOUT XLFD NAMES 

If the xlfdname argument contains any embedded blanks the entire XLFD name should be 
enclosed in quotes. Also, while it is good practice to ahvays specify something in all XLFD fields, 
null fields (double dashes) are permissible and will be treated as though they contain asterisk 
wildcards. Certain fields of the XLFD name will "default" if specified as zero or wild: 

Point Size (field 8) - default value is 120 (12 point) 

X resolution (field 9) - default value is 100 dots per inch (BDF/SNF) 

default value is printer resolution (PCL) 
Y resolution (field 10) - default value is 100 dots per inch (BDF/SNF) 
default value is printer resolution (PCL) 

Resolution of other fields containing wildcards depends wholly on the contents and ordering of 
data in fonts.dir and charsets.dir. 

ABOUT THE VARIOUS PCL FORMATS 

The PCL bitmapped output formats for the various LaserJet printers are identical. Stmkfont uses 
the format specified with the -/ option to ensure that the font will work within the restrictions 
imposed by the target printer. For example, the LIPLUS printer cannot handle the large glyphs 
allowed by the other models, nor can it handle character sets that define glyphs for the control 
characters. 

EXAMPLES 

To generate a BDF file for a 14-point/llO DPI "eg times" font using the iso8859-l character set: 

stmkfont "-agfa-cgtimes-normal-r-normal-*-*-140-110-110-*-*-iso8859-l" 
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To generate the same font for a LaserJet II: 

stmkfont -f LJII "-agfa-cg times-nomial-r-normal-*-*-140-*-*-*-*-iso8859-l" 

Note that the resolution fields will default to the printer's 300 DPI resolution. The output will be 
a LaserJet II font without the font management sequences for assigning font ID and for making 
the font temporary or permanent. 

To search for fonts in a directory "$HOME/fonts" containing scalable fonts and a fonts.dir direc- 
tory: 

stmkfont -dl "$HOME/fonts" "-agfa-cg times-normal-r — 140 hp-roman8" 

Note here that empty fields are simply run together as a string of dashes. While this is an 
unrecommended departure from the XLFD format standard, stmkfont will allow such a 
specification and treats the empty fields as though they contain asterisk wildcards. 

FILES 

/usr/lib/Xll/fonts/stadmin/ifo/charsets/charsets.dir 

/usr/lib/Xll/fonts/ifo.st/typefaces/fonts.dir 

/usr/lib/Xll/fonts/stadmin/misc/st.dev 

ERRORS 

Typeface does not contain an HP alias 

The typeface file does not contain sufficient information to construct a PCL font. 

UPLUS printer does not support this charset 

A character set was requested that cannot be used on the LaserJet Plus printer. Any 
character set that defines glyphs for characters 0-31 or 128-159 cannot be used on the 
LaserJet Plus printer. 

Font too large for printer 

The requested font size is larger than can be handled by the target printer. 

SEE ALSO 

bdftosnf(l), mkfontdir(l), stmkdirs(l), stlicense(lM), stload(lM) 

COPYRIGHT 

(C) Copyright 1990 Hewlett-Packard Company 
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NAME 

X - a portable, network-transparent window system 

SYNOPSIS 

The X Window System is a network transparent window system developed at MIT which runs 
on a wide range of computing and graphics machines. The core distribution from MIT has 
support for the following operating systems: 

Ultrix 3.1 (Digital) 

SunOS 4.0.3 (Sun) 

HP-UX 6.5 (Hewlett-Packard) 

Domain/OS 10.1 (HP/Apollo) 

A/UX 1.1 (Apple) 

AIX RT-2.2 and PS/2-1.1 (IBM) 

AOS-4.3 (IBM) 

UTEK 4.0 (Tektronix) 

NEWS-OS 3.2 (Sony, client only) 

UNICOS 5.0.1 (Cray; client only) 

UNIX(tm) System V, Release 3.2 (AT&T 6386 WGS; client only) 

It should be relatively easy to build the client-side software on a variety of other system. 
Commercial implementations are also available for a wide range of platforms. 

The X Consortium requests that the following names be used when referring to this software: 

X 

X Window System 

X Version 11 

X Window System, Version 11 

Xll 

X Window System is a trademark of the Massachusetts Institute of Technology. 

DESCRIPTION 

X Window System servers run on computers with bitmap displays. The server distributes user 
input to and accepts output requests from various client programs through a variety of different 
interprocess communication channels. Although the most common case is for the client programs 
to be running on the same machine as the server, clients can be run transparently from other 
machines (including machines with different architectures and operating systems) as well. 

X supports overlapping hierarchical subwindows and text and graphics operations, on both mono- 
chrome and color displays. For a full explanation of the functions that are available, see the Xlib - 
C Language X Interface manual, the X Window System Protocol specification, the X Toolkit Intrin- 
sics - C Language Interface manual, and various toolkit documents. 

The number of programs that use X is growing rapidly. Of particular interest are: a terminal 
emulator (xterm), a window manager (pvm), a display manager (xdm), mail managing utilities 
(pcmh and xbifl^, a manual page browser (xman), a bitmap editor (bitmap), access control pro- 
grams (xauth and xhost), user preference setting programs (xrdb, xset, xsetroot, and xmodmap), a 
load monitor (xload), clocks (xclock and oclock), a font displayer (xfd), utilities for listing informa- 
tion about fonts, windows, and displays (xlsfonts, xfontsel, xlswins, xwininfo, xlsclients, xdpyinfo, 
and xprop), a diagnostic for seeing what events are generated and when (xev), screen image mani- 
pulation utilities (xwd, xwud, xpr, and xmag), and various demos (xeyes, ico, muncher, puzzle, xgc, 
etc.). 

Many other utilities, window managers, games, toolkits, etc. are available from the user- 
contributed software. See your site administrator for details. 

STARTING UP 

There are two main ways of getting the X server and an initial set of client applications started. 
The particular method used depends on what operating system you are running and on whether or 
not you use other window systems in addition to X. 
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xdm (the X Display Manager) 

If you want to always have X running on your display, your site administrator can set 
your machine up to use the X Display Manager xtim. This program is typically started by 
the system at boot time and takes care of keeping the server running and getting users 
logged in. If you are running ;t^//n, you will see a window on the screen welcoming you to 
the system and asking for your usemame and password. Simply type them in as you 
would at a normal terminal, pressing the Return key after each. If you make a mistake, 
xdm will display an error message and ask you to try again. After you have successfully 
logged in, xdm will start up your X environment. By default, if you have an executable 
file named jcsession in your home directory, xdm will treat it as a program (or shell 
script) to run to start up your initial clients (such as terminal emulators, clocks, a window 
manager, user settings for things like the background, the speed of the pointer, etc.). 
Your site administrator can provide details. 

xinit (run manually from the shell) 

Sites that support more than one window system might choose to use the xinit program 
for starting X manually. If this is true for your machine, your site administrator will 
probably have provided a program named Sell", "startx", or "xstart" that will do site- 
specific initialization (such as loading convenient default resources, running a window 
manager, displaying a clock, and starting several terminal emulators) in a nice way. If 
not, you can build such a script using the xinit program. This utility simply runs one 
user-specified program to start the server, runs another to start up any desired clients, 
and then waits for either to finish. Since either or both of the user-specified programs 
may be a shell script, this gives substantial flexibility at the expense of a nice interface. 
For this reason, .««iY is not intended for end users. 

DISPLAY NAMES 

From the user's prospective, every X server has a display name of the form: 

hostname:displaynumber.screennumber 

This information is used by the application to determine how it should connect to the server and 
which screen it should use by default (on displays with multiple monitors): 

hostname 

The hostname specifies the name of the machine to which the display is physically con- 
nected. If the hostname is not given, the most efficient way of communicating to a server 
on the same machine will be used. 

displaynumber 

The phrase "display" is usually used to refer to collection of monitors that share a com- 
mon keyboard and pointer (mouse, tablet, etc.). Most workstations tend to only have 
one keyboard, and therefore, only one display. Larger, multi-user systems, however, will 
frequently have several displays so that more than one person can be doing graphics 
work at once. To avoid confusion, each display on a machine is assigned a display 
number (beginning at 0) when the X server for that display is started. The display 
number must always be given in a display name. 

screennumber 

Some displays share a single keyboard and pointer among two or more monitors. Since 
each monitor has its own set of windows, each screen is assigned a screen number (begin- 
ning at 0) when the X server for that display is started. If the screen number is not given, 
then screen will be used. 

On POSIX systems, the default display name is stored in your DISPLAY environment variable. 
This variable is set automatically by the xterm terminal emulator. However, when you log into 
another machine on a network, you'll need to set DISPLAY by hand to point to your display. For 
example. 



% setenv DISPLAY myws:0 

$ DISPLAY =myws:0; export DISPLAY 
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Finally, most X programs accept a command line option of -display displayname to temporarily 
override the contents of DISPLAY. This is most commonly used to pop windows on another 
person's screen or as part of a "remote shell" command to start an xterm pointing back to your 
display. For example, 

% xeyes -display joesws:0 -geometry 1000x1000+0+0 
% rsh big xterm -display myws:0 -Is </dev/null & 

X servers listen for connections on a variety of different communications channels (network byte 
streams, shared memory, etc.). Since there can be more than one way of contacting a given server. 
The hostname part of the display name is used to determine the type of channel (also called a 
transport layer) to be used. The sample servers from MIT support the following types of connec- 
tions: 



local 



TCP/IP 



The hostname part of the display name should be the empty string. For example: :0, :1, 
and :0.1. The most efficient local transport will be chosen. 

The hostname part of the display name should be the server machine's IP address name. 
Full Internet names, abbreviated names, and IP addresses are all allowed. For example: 
expo.lcs.mit.edu:0, expo:0, 18.30.0.212:0, bigmachinetl, and hydra:0.1. 

DECnet 

The hostname part of the display name should be the server machine's nodename fol- 
lowed by two colons instead of one. For example: myws::0, big::l, and hydra::0.1. 

ACCESS CONTROL 

The sample server provides two types of access control: an authorization protocol which provides 
a list of "magic cookies" clients can send to request access, and a list of hosts from which connec- 
tions are always accepted. Xdm initializes magic cookies in the server, and also places them in a 
file accessible to the user. Normally, the list of hosts from which connections are always accepted 
should be empty, so that only clients with are explicitly authorized can connect to the display. 
When you add entries to the host list (with xhost), the server no longer performs any authorization 
on connections from those machines. Be careful with this. 

The file for authorization which both xdm and JGib use can be specified with the environment 
variable XAUTHORITY, and defaults to the file ^authority in the home directory. Xdm uses 
$HOME/^authority and will create it or merge in authorization records if it already exists when a 
user logs in. 

To manage a collection of authorization files containing a collection of authorization records use 
xauth. This program allows you to extract records and insert them into other files. Using this, you 
can send authorization to remote machines when you login. As the files are machine- 
independent, you can also simply copy the files or use NFS to share them. If you use several 
machines, and share a common home directory with NFS, then you never really have to worry 
about authorization files, the system should work correctly by default. Note that magic cookies 
transmitted "in the clear" over NFS or using^p or rep can be "stolen" by a network eavesdropper, 
and as such may enable unauthorized access. In many environments this level of security is not a 
concern, but if it is, you need to know the exact semantics of the particular magic cookie to know if 
this is actually a problem. 

GEOMETRY SPECIFICATIONS 

One of the advantages of using window systems instead of hardwired terminals is that applications 
don't have to be restricted to a particular size or location on the screen. Although the layout of 
windows on a display is controlled by the window manager that the user is running (described 
below), most X programs accept a command line argument of the form -geometry 
WIDTHxHEIGHT+XOFF+YOFF (where WIDTH, HEIGHT, XOFF, and YOFF are numbers) for 
specifying a preferred size and location for this application's main window. 

The WIDTH and HEIGHT parts of the geometry specification are usually measured in either pix- 
els or characters, depending on the application. The XOFF and YOFF parts are measured in pix- 
els and are used to specify the distance of the window from the left or right and top and bottom 
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edges of the screen, respectively. Both types of offsets are measured from the indicated edge of 
the screen to the corresponding edge of the window. The X offset may be specified in the follow- 
ing ways: 

+XOFF The left edge of the window is to be placed XOFF pixels in from the left edge of the 
screen (i.e. the X coordinate of the window's origin will be XOFF). XOFF may be nega- 
tive, in which case the window's left edge will be off the screen. 

-XOFF The right edge of the window is to be placed XOFF pixels in from the right edge of the 
screen. XOFF may be negative, in which case the window's right edge will be off the 
screen. 

The Y offset has similar meanings: 

+YOFF The top edge of the window is to be YOFF pixels below the top edge of the screen (i.e. 
the Y coordinate of the window's origin will be YOFF). YOFF may be negative, in which 
case the window's top edge will be off the screen. 

-YOFF The bottom edge of the window is to be YOFF pixels above the bottom edge of the 
screen. YOFF may be negative, in which case the window's bottom edge will be off the 
screen. 

Offsets must be given as pairs; in other words, in order to specify cithetXOFF or YOFF both must 
be present. Windows can be placed in the four comers of the screen using the following 
specifications: 

+0+0 upper left hand comer. 

-0+0 upper right hand comer. 

-0-0 lower right hand comer. 

■\-0-0 lower left hand comer. 

In the following examples, a terminal emulator will be placed in roughly the center of the screen 
and a load average monitor, mailbox, and clock will be placed in the upper right hand comer: 

xterm -fn 6x10 -geometry 80x24 + 30 + 200 & 
xclock -geometry 48x48-0+0 & 
xload -geometry 48x48-96+0 & 
xbiff -geometry 48x48-48+0 & 

WINDOW MANAGERS 

The layout of windows on the screen is controlled by special programs called window managers. 
Although many window managers will honor geometry specifications as given, others may choose 
to ignore them (requiring the user to explicitly draw the window's region on the screen with the 
pointer, for example). 

Since window managers are regular (albeit complex) client programs, a variety of different user 
interfaces can be built. The core distribution comes with a window manager named twm which 
supports overlapping windows, popup menus, point-and-click or click-to-type input models, title 
bars, nice icons (and an icon manager for those who don't like separate icon windows). 

Several other window managers are available in the user-contributed software: g^vm, m_swm, 
olwm, and tekwm. 

FONT NAMES 

Collections of characters for displaying text and symbols in X are known as fonts. A font typically 
contains images that share a common appearance and look nice together (for example, a single 
size, boldness, slant, and character set). Similarly, collections of fonts that are based on a common 
type face (the variations are usually called roman, bold, italic, bold italic, oblique, and bold 
oblique) are called families. 

Sets of font families of the same resolution (usually measured in dots per inch) are further 
grouped into directories (so named because they were initially stored in file system directories). 
Each directory contains a database which lists the name of the font and information on how to 
find the font. The server uses these databases to translate font names (which have nothing to do 
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with file names) into font data. 

The list of font directories in which the server looks when trying to find a font is controlled by the 
font path. Although most installations will choose to have the server start up with all of the com- 
monly used font directories, the font path can be changed at any time with the xset program. How- 
ever, it is important to remember that the directory names are on the server's machine, not on the 
application's. 

The default font path for the sample server contains three directories: 

/usr/lib/Xll /fonts /misc 

This directory contains many miscellaneous fonts that are useful on all systems. It con- 
tains a small family of fixed-width fonts in pixel heights 5 through 10, a family of fixed- 
width fonts from Dale Schumacher in similar pixel heights, several Kana fonts from Sony 
Corporation, a Kanji font, the standard cursor font, two cursor fonts from Digital Equip- 
ment Corporation, and OPEN LOOK(tm) cursor and glyph fonts from Sun Microsys- 
tems. It also has font name aliases for the font names fixed and variable. 

/usr/lib/Xll /fonts /75dpi 

This directory contains fonts contributed by Adobe Systems, Inc., Digital Equipment 
Corporation, Bitstream, Inc., Bigelow and Holmes, and Sun Microsystems, Inc. for 75 
dots per inch displays. An integrated selection of sizes, st^es, and weights are provided 
for each family. 

/usr/lib/Xll /fonts /100dpi 

This directory contains 100 dots per inch versions of some of the fonts in the 75dpi direc- 
tory. 

Font databases are created by running the mkfontdir program in the directory containing the 
source or compiled versions of the fonts (in both compressed and uncompressed formats). When- 
ever fonts are added to a directory, mkfontdir should be rerun so that the server can find the new 
fonts. To make the server reread the font database, reset the font path with the xset program. For 
example, to add a font to a private directory, the following commands could be used: 

% cp newfont.snf "/myfonts 
% mkfontdir "/myfonts 
% xset fp rehash 

The xlsfonts program can be used to list all of the fonts that are found in font databases in the 
current font path. Font names tend to be fairly long as they contain all of the information needed 
to uniquely identify individual fonts. However, the sample server supports wildcarding of font 
names, so the full specification 

-adobe-courier-medium-r-normal-10-100-75'75-m-60-iso8859-l 

could be abbreviated as: 

- *-courier-niedium-r-nomtal- *-100-*- *- *- *- *- * 

or, more tersely (but less accurately): 

*-courier-medium-r-normal~ *-l 00- * 
Because the shell also has special meanings for • and ?, wildcarded font names should be quoted: 

% xlsfonts -fn '*-courier-medium-r-normal~*-100-*' 

If more than one font in a given directory in the font path matches a wildcarded font name, the 
choice of which particular font to return is left to the server. However, if fonts from more than 
one directory match a name, the returned font will always be from the first such directory in the 
font path. The example given above will match fonts in both the 75dpi and 100dpi directories; if 
the 75dpi directory is ahead of the 100dpi directory in the font path, the smaller version of the font 
will be used. 
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COLOR NAMES 

Most applications provide ways of tailoring (usually through resources or command line argu- 
ments) the colors of various elements in the text and graphics they display. Although black and 
white displays don't provide much of a choice, color displays frequently allow anywhere between 
16 and 16 million different colors. 

Colors are usually specified by their commonly-used names (for example, red, white, or medium 
slate blue). The server translates these names into appropriate screen colors using a color data- 
base that can usually be found in /usr/lib/Xll/r^.txt. Color names are case-insensitive, meaning 
that red. Red, and RED all refer to the same color. 

Many applications also accept color specifications of the following form: 

#rgb 

#rrggbb 

#rrrgggbbb 

#rrrrgggg;bbbb 

where r, g, and b are hexadecimal numbers indicating how much red, green, and blue should be 
displayed (zero being none and ffff being on full). Each field in the specification must have the 
same number of digits (e.g., #rrgb or #g;bb are not allowed). Fields that have fewer than four 
digits (e.g. #rgb) are padded out with zero's following each digit (e.g. #rOOOgOOObOOO). The eight 
primary colors can be represented as: 

black #000000000000 (no color at all) 

red #frffOOOOOOOO 

green #OOOOffflP0OOO 

blue #00000000frfif 

yellow #fffffffiDOOO (full red and green, no blue) 

magenta #fffiP0OOOfrflF 

cyan #0000£fffffff 

white #ffffffffffff (full red, green, and blue) 

Unfortunately, RGB color specifications are highly unportable since different monitors produce 
different shades when given the same inputs. Similarly, color names aren't portable because there 
is no standard naming scheme and because the color database needs to be tuned for each moni- 
tor. 



KEYS 



Application developers should take care to make their colors tailorable. 

The X keyboard model is broken into two layers: server-specific codes (called keycodes) which 
represent the physical keys, and server-independent symbols (called keysyms) which represent the 
letters or words that appear on the keys. Two tables are kept in the server for converting keycodes 
to keysyms: 

modifier list 

Some keys (such as Shift, Control, and Caps Lock) are known as modifier and are used 
to select different symbols that are attached to a single key (such as Shift-a generates a 
capital A, and Control-1 generates a formfeed character '^L). The server keeps a list of 
keycodes corresponding to the various modifier keys. Whenever a key is pressed or 
released, the server generates an event that contains the keycode of the indicated key as 
well as a mask that specifies which of the modifier keys are currently pressed. Most 
servers set up this list to initially contain the various shift, control, and shift lock keys on 
the keyboard. 

keymap table 

Applications translate event keycodes and modifier masks into keysyms using a keysym 
table which contains one row for each keycode and one column for various modifier 
states. This table is initialized by the server to correspond to normal typewriter conven- 
tions, but is only used by client programs. 
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Although most programs deal with keysyms directly (such as those written with the X Toolkit 
Intrinsics), most programming libraries provide routines for converting keysyms into the appropri- 
ate type of string (such as ISO Latin-1). 

OPTIONS 

Most X programs attempt to use the same names for command line options and arguments. All 
applications written with the X Toolkit Intrinsics automatically accept the following options: 

•display display 

liiis option specifies the name of the X server to use. 

-geometry geometry 

This option specifies the initial size and location of the window. 

-bg color, -background color 

Either option specifies the color to use for the window background. 

-bd color, -bordercolor color 

Either option specifies the color to use for the window border. 

-bw number, -borderwidth number 

Either option specifies the width in pixels of the window border. 

•^ color, -foreground color 

Either option specifies the color to use for text or graphics. 

•in. font, -font font 

Either option specifies the font to use for displaying text. 

-iconic 

This option indicates that the user would prefer that the application's windows initially 
not be visible as if the windows had be immediately iconified by the user. Window 
managers may choose not to honor the application's request. 

-name 

This option specifies the name under which resources for the application should be 
found. This option is useful in shell aliases to distinguish between invocations of an 
application, without resorting to creating links to alter the executable file name. 

-rv, -reverse 

Either option indicates that the program should simulate reverse video if possible, often 
by swapping the foreground and background colors. Not all programs honor this or 
implement it correctly. It is usually only used on monochrome displays. 

+rv 

This option indicates that the program should not simulate reverse video. This is used to 
override any defaults since reverse video doesn't always work properly. 

•selectionTimeout 

This option specifies the timeout in milliseconds within which two communicating appli- 
cations must respond to one another for a selection request. 

-synchronous 

This option indicates that requests to the X server should be sent synchronously, instead 
of asynchronously. Since Xlib normally buffers requests to the server, errors do not 
necessarily get reported immediately after they occur. This option turns off the buffering 
so that the application can be debugged. It should never be used with a working pro- 
gram. 

-title string 

This option specifies the title to be used for this window. This information is sometimes 
used by a window manager to provide some sort of header identifying the window. 

-xnllanguage language{Jerritory] {.codeset] 

This option specifies the language, territory, and codeset for use in resolving resource 
and other filenames. 
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-xrm resourcestring 

This option specifies a resource name and value to override any defaults. It is also very 
useful for setting resources that don't have explicit command line arguments. 

RESOURCES 

To make the tailoring of applications to personal preferences easier, X supports several mechan- 
isms for storing default values for program resources (e.g. background color, window title, etc.) 
Resources are specified as strings of the form 

appname*subname*subsubnatne...: value 

that are read in from various places when an application is run. By convention, the application 
name is the same as the program name, but with the first letter capitalized (e.g. Bitmap or Emacs) 
although some programs that begin with the letter "x" also capitalize the second letter for histori- 
cal reasons. The precise syntax for resources is: 

ResourceLine = Comment | ResourceSpec 

Comment = "!" string | < empty line > 

ResourceSpec = WhiteSpace ResourceName WhiteSpace ":" WhiteSpace value 

ResourceName = [Binding] ComponentName {Binding ComponentName} 

Binding = "." | "*" 

WhiteSpace = {" " | "\f} 

ComponentName = {"a"-"z'' | "A"-"Z" | "0"-"9'' | "_" | "-••} 

value = string 

string = { < any character not including "\n" > } 

Note that elements enclosed in curly braces ({...}) indicate zero or more occurrences of the 
enclosed elements 

To allow values to contain arbitrary octets, the 4-character sequence \nnn, where n is a digit in the 
range of "0"-'7", is recognized and replaced with a single byte that contains this sequence inter- 
preted as an octal number. For example, a value containing a NULL byte can be stored by speci- 
fying "XOOO". 

The Xlib routine XGetDefault(3X) and the resource utilities within Xlib and the X Toolkit Intrin- 
sics obtain resources from the following sources: 

RESOURCEMANAGER root window property 

Any global resources that should be available to clients on all machines should be stored 
in the RESOURCE_MANAGER property on the root window using the xrdb program. 
This is frequently taken care of when the user starts up X through the display manager 
otxinit. 

application-specific files 

Programs that use the X Toolkit Intrinsics will also look in the directories named by the 
environment variable XUSERFILESEARCHPATH or the environment variable XAP- 
PLRESDIR, plus directories in a standard place (usually under /usr/lib/Xll/, but this 
can be overridden with the XFILESEARCHPATH environment variable) for 
application-specific resources. See ih&X Toolkit Intrinsics - C Language Interface manual 
for details. 

XENVIRONMENT 

Any user- and machine-specific resources may be specified by setting the XENVIRON- 
MENT environment variable to the name of a resource file to be loaded by all applica- 
tions. If this variable is not defined, a file named $HOME/.Xde{au\ts-hostname is 
looked for instead, where hostname is the name of the host where the application is exe- 
cuting. 

-xrm resourcestring 

Applications that use the X Toolkit Intrinsics can have resources specified from the com- 
mand line. The resourcestring is a single resource name and value as shown above. Note 
that if the string contains characters interpreted by the shell (e.g., asterisk), they must be 
quoted. Any number of -xrm arguments may be given on the command line. 
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Program resources are organized into groups called classes, so that collections of individual 
resources (each of which are called instances) can be set all at once. By convention, the instance 
name of a resource begins with a lowercase letter and class name with an upper case letter. Multi- 
ple word resources are concatenated with the first letter of the succeeding words capitalized. 
Applications written with the X Toolkit Intrinsics will have at least the following resources: 

background (class Background) 

This resource specifies the color to use for the window background. 

borderWidth (class BorderWidth) 

This resource specifies the width in pixels of the window border. 

borderColor (class BorderColor) 

This resource specifies the color to use for the window border. 

Most applications using the X Toolkit Intrinsics also have the resource for^round (class Fore- 
ground), specifying the color to use for text and graphics within the window. 

By combining class and instance specifications, application preferences can be set quickly and 
easily. Users of color displays will frequently want to set Background and Foreground classes to 
particular defaults. Specific color instances such as text cursors can then be overridden without 
having to define all of the related resources. For example, 

bitmap*Dashed: off 
XTerm*cursorColor: gold 
XTerm*multiScroll: on 
XTerm*jumpScroll: on 
XTerm*reverseWrap: on 
XTerm*curses: on 
XTerm*Font: 6x10 
XTerm*scrollBar: on 
XTerm*scrollbar*thickness: 5 
XTerm*multiClickTime: 500 
XTerm*charClass: 33:48,37:48,45-47:48,64:48 
XTerm*cutNewline: off 
XTerm*cutToBeginningOfLine: off 
XTerm*titeInhibit: on 
XTerm'ttyModes: intr ^c erase ^? kill ^u 
XLoad*Background: gold 
XLoad*Foreground: red 
XLoad*highlight: black 
XLoad*borderWidth: 
emacs* Geometry: 80x65-0-0 
emacs*Background: #5b7686 
emacs*Foreground: white 
emacs* Cursor: white 
emacs*BorderColor: white 
emacs*Font: 6x10 
xmag*geometry: -0-0 
xmag*borderColor: white 

If these resources were stored in a file called JCresources in your home directory, they could be 
added to any existing resources in the server with the following command: 

% xrdb -merge $HOME/.Xresources 

This is frequently how user-friendly startup scripts merge user-specific defaults into any site-wide 
defaults. All sites are encouraged to set up convenient ways of automatically loading resources. 
See the Xlib manual section Using the Resource Manager for more information. 

EXAMPLES 

The following is a collection of sample command lines for some of the more frequently used 
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commands. For more information on a particular command, please refer to that command's 
manual page. 

% xrdb -load $HOME/.Xresources 

% xmodmap -e "keysym Backspace = Delete" 

% mkfontdir /usr/local/lib/Xll/otherfonts 

% xsetfp+ /usr/local/lib/Xll/otherfonts 

% xmodmap $HOME/.keymap.km 

% xsetroot -solid '#888' 

% xset b 100 400 c 50 s 1800 r on 

% xsetq 

% twm 

% xmag 

% xclock -geometry 48x48-0+0 -bg blue -fg white 

% xeyes -geometry 48x48-48+0 

% jdsiff -update 20 

% xlsfonts '*helvetica*' 

% xlswins -1 

% xwininfo -root 

% xdpyinfo -display joesworkstation:0 

% xhost -joesworkstation 

% xrefresh 

% xwd I xwud 

% bitmap companylogo.bm 32x32 

% xcalc -bg blue -fg magenta 

% xterm -geometry 80x66-0-0 -name myxterm $* 

DIAGNOSTICS 

A wide variety of error messages are generated from various programs. Various toolkits are 
encouraged to provide a common mechanism for locating error text so that applications can be 
tailored easily. Programs written to interface directly to the XLib C language library are expected 
to do their own error checking. 

The default error handler in Xlib (also used by many toolkits) uses standard resources to con- 
struct diagnostic messages when errors occur. The defaults for these messages are usually stored 
in /usr/lib /Xll /XErrorDB . If this file is not present, error messages will be rather terse and cryp- 
tic. 

When the X Toolkit Intrinsics encounter errors converting resource strings to the appropriate 
internal format, no error messages are usually printed. This is convenient when it is desirable to 
have one set of resources across a variety of displays (e.g. color vs. monochrome, lots of fonts vs. 
very few, etc.), although it can pose problems for trying to determine why an application might be 
failing. This behavior can be overridden by the setting the StringConversionsWaming resource. 

To force the X Toolkit Intrinsics to always print string conversion error messages, the following 
resource should be placed at the top of the file that gets loaded onto the 
RESOURCE_MANAGER property using the xrdb program (frequently called JCresources or 
JCres in the user's home directory): 

*StringConversionWamings: on 

To have conversion messages printed for just a particular application, the appropriate instance 
name can be placed before the asterisk: 



BUGS 



xterm *StringConversionWamings: on 

If you encounter a repeatable bug, please contact your site administrator for instructions on how 
to submit an X Bug Report. 
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SEE ALSO 

XConsortium(l), XStandards(l), appres(l), bdftosnf(l), bitmap(l), imake(l), listres(l), maze(l), 
mkfontdir(l), muncher(l), oclock(l), puzzle(l), resize(l), showsnf(l), twm(l), xauth(l), 3d>iff(l), 
xcalc(l), xclipboard(l), xclock(l), xditview(l), xdm(l), xdpyinfo(l), xedit(l), xev(l), xeyes(l), 
xfd(l), xfontsel(l), xhost(l), xinit(l), xkill(l), xload(l), xlogo(l), xlsatoms(l), xlsclients(l), 
xlsfonts(l), xlswins(l), xmag(l), xman(l), xmh(l), xmodmap(l), xpr(l), xprop(l), xrdb(l), 
xrefresh(l), xset(l), xsetroot(l), xstdcmap(l), xtenn(l), xwd(l), xwininfo(l), xwud(l), Xsei"ver(l), 
Xapollo(l), Xcfbpmax(l), Xhp(l), Xibm(l), XmacII(l), Xmfbpmax(l), Xqdss(l), Xqvss(l), 
Xsun(l), Xtek(l), kbd_mode(l), todm(l), to<l), biff(l), init(8), ttys(5), Xlib - C Language X Inter- 
face, X Toolkit Intrinsics - C Language Interface, and Using and Specifying X Resources 

COPYRIGHT 

The following copyright and permission notice outlines the rights and restrictions covering most 
parts of the core distribution of the X Window System from MIT. Other parts have additional or 
different copyrights and permissions; see the individual source files. 

Copyright 1984, 1985, 1986, 1987, 1988, and 1989, by the Massachusetts Institute of Technology. 

Permission to use, copy, modify, distribute, and sell this software and its documentation for any 
purpose is hereby granted without fee, provided that the above copyright notice appear in all 
copies and that both that copyright notice and this permission notice appear in supporting docu- 
mentation, and that the name of MIT not be used in advertising or publicity pertaining to distribu- 
tion of the software without specific, written prior permission. MIT makes no representations 
about the suitability of this software for any purpose. It is provided "as is" without express or 
implied warranty. 

This software is not subject to any license of the American Telephone and Telegraph Company or 
of the Regents of the University of California. 

TRADEMARKS 

UNIX and OPEN LOOK are trademarks of AT&T. X Window System is a trademark of MIT. 

AUTHORS 

A cast of thousands, literally. The X distribution is brought to you by the MIT X Consortium. 
The staff members at MIT responsible for this release are: Donna Converse (MIT X Consor- 
tium), Jim Fulton (MIT X Consortium), Michelle Leger (MIT X Consortium), Keith Packard 
(MIT X Consortium), Chris Peterson (MIT X Consortium), Bob Scheifler (MIT X Consortium), 
and Ralph Swick (Digital/MIT Project Athena). 
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NAME 

xllstart - start the Xll window system 

SYNOPSIS 

xllstart [options] 

DESCRIPTION 

xllstart starts up the X window system by running the Xll window server and selected Xll clients. 
By default, hptenn(l) and mwm(l) are run by xllstart. 

xllstart is a shell script that first checks the user's home directory for a JCdefaults file. If there is 
no JCdefaults file there, then the file /usr/lib/Xll/sysJCdefaults (if it exists) will be used as a 
source file for xrdb(l), to create a RESOURCE_MANAGER property. This is done by setting 
the variable $doxrdb, which is executed in the .xllstart file, and thus under user control. 

xllstart will modify the PATH variable as needed to assure that /usr/bin/XU is in the users 
PATH variable in front of /usr/bin. 

xllstart then runs xinit using the shell script jcllstart from the user's home directory as the first 
argument for xinit. If that script does not exist or is not executable, then the script 
/usr/lib /Xll /sysjcllstart is used as the argument for xinit. In any case the arguments passed to 
xllstart are passed on io xinit following the jcllstart argument. 

FILES 

/usr/lib/Xll/sys.xllstart 
$HOME/.xllstart 
/usr/lib/Xll/sys.Xdefaults 
$HOME/.Xdefaults 

ORIGIN 

HP 

SEE ALSO 

X(l), xinit(l), hpterm(l), mwm(l), xrdb(l) 
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NAME 

xcHpboard - X clipboard client 

SYNOPSIS 

xclipboard [ -toolkitoption ...] [-w] [-nw] 

DESCRIPTION 

The xclipboard program is used to collect and display text selections that are sent to the CLIP- 
BOARD by other clients. It is typically used to save CLIPBOARD selections for later use. It 
stores each CLIPBOARD selection as a separate string, each of which can be selected. Each time 
CLIPBOARD is asserted by another application, xclipboard transfers the contents of that selection 
to a new buffer and displays it in the text window. Buffers are never automatically deleted, so 
you'll want to use the delete button to get rid of useless items. 

Since xclipboard uses a Text Widget to display the contents of the clipboard, text sent to the CLIP- 
BOARD may be re-selected for use in other applications, xclipboard also responds to requests for 
the CLIPBOARD selection from other clients by sending the entire contents of the currently 
displayed buffer. 

An xclipboard window has the following buttons across the top: 

quit When this button is pressed, xclipboard exits. 

delete When this button is pressed, the current buffer is deleted and the next one displayed. 

new Creates a new buffer with no contents. Useful in constructing a new CLIPBOARD 
selection by hand. 

next Displays the next buffer in the list. 

previous Displays the previous buffer. 

OPTIONS 

The xclipboard program accepts all of the standard X Toolkit command line options as well as the 
following: 

-w This option indicates that lines of text that are too long to be displayed on one line in the 

clipboard should wrap around to the following lines. 

-nw This option indicates that long lines of text should not wrap around. This is the default 

behavior. 

WIDGETS 

In order to specify resources, it is useful to know the hierarchy of the widgets which compose 
xclipboard. In the notation below, indentation indicates hierarchical structure. The widget class 
name is given first, followed by the widget instance name. 

xclipboard xclipboard 
Form form 

Command quit 
Command delete 
Command new 
Command next 
Command prev 
Text text 

SENDING/RETRIEVING CLIPBOARD CONTENTS 

Text is copied to the clipboard whenever a client asserts ownership of the CLIPBOARD selection. 
Text is copied from the clipboard whenever a client requests the contents of the CLIPBOARD 
selection. Examples of event bindings that a user may wish to include in a resource configuration 
file to use the clipboard are: 

*VT100.Translations: #override \ 

< Btn3Up> : select-end(CUPBOARD) \n\ 

< Btn2Up > : insert-selection(PRIMARY,CLIPBOARD) \n\ 
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<Btn2Down>: ignore () 



SEE ALSO 

X(l), xcutsel(l), xterm(l), individual client documentation for how to make a selection and send it 
to the CLIPBOARD. 

ENVIRONMENT 

DISPLAY 

to get the default host and display number. 

XENVIRONMENT 

to get the name of a resource file that overrides the global resources stored in the 
RESOURCE MANAGER property. 

FILES 

/usr/lib/Xll/app-defaults/XClipboard - specifies required resources 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology 
SccX(l) for a full statement of rights and permissions. 

AUTHOR 

Ralph R. Swick, DEC/MIT Project Athena 
Chris D. Peterson, MIT X Consortium 
Keith Packard, MIT X Consortium 
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NAME 

xclock - analog / digital clock for X 

SYNOPSIS 

xclock [-toolkitoption ...] [-help] [-analog] [-digital] [-chime] [-hd color] 
[-hi color] [-update seconds] [-padding number] 

DESCRIPTION 

The xclock program displays the time in analog or digital form. The time is continuously updated 
at a frequency which may be specified by the user. This program is nothing more than a wrapper 
around the Athena Clock widget. 

OPTIONS 

Xclock accepts all of the standard X Toolkit command line options along with the additional 
options listed below: 

-help This option indicates that a brief summary of the allowed options should be printed on 
the standard error. 

-analog This option indicates that a conventional 12 hour clock face with tick marks and hands 
should be used. This is the default. 

-digital This option indicates that a 24 hour digital clock should be used. 

-chime This option indicates that the clock should chime once on the half hour and twice on the 
hour. 

-hd color 

This option specifies the color of the hands on an analog clock. The default is black. 

-hi color This option specifies the color of the edges of the hands on an analog clock, and is only 
useful on color displays. The default is black. 

-update seconds 

This option specifies the frequency in seconds at which xclock should update its display. 
If the clock is obscured and then exposed, it will be updated immediately. A value of less 
than 30 seconds will enable a second hand on an analog clock. The default is 60 seconds. 

-padding number 

This option specifies the width in pixels of the padding between the window border and 
clock text or picture. The default is 10 on a digital clock and 8 on an analog clock. 

X DEFAULTS 

This program uses the Athena Clock widget. It understands all of the core resource names and 
classes as well as: 

width (class Width) 

Specifies the width of the clock. The default for analog clocks is 164 pixels; the default 
for digital clocks is whatever is needed to hold the clock when displayed in the chosen 
font. 

height (class Height) 

Specifies the height of the clock. The default for analog clocks is 164 pixels; the default 
for digital clocks is whatever is needed to hold the clock when displayed in the chosen 
font. 

update (class Interval) 

Specifies the frequency in seconds at which the time should be redisplayed. 

foreground (class Foreground) 

Specifies the color for the tic marks. The default depends on whether reverseVideo is 
specified. \i reverseVideo is specified the default is white, otherwise the default is black. 

hands (class Foreground) 

Specifies the color of the insides of the clock's hands. The default depends on whether 
reverseVideo is specified. If reverseVideo is specified the default is white, otherwise the 
default is black. 
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highlight (class For^round) 

Specifies the color used to highlight the clock's hands. The default depends on whether 
reverseVideo is specified. If reverseVideo is specified the default is white, otherwise the 
default is black. 

analog (class Boolean) 

Specifies whether or not an analog clock should be used instead of a digital one. The 
default is True. 

chime (class Boolean) 

Specifies whether or not a bell should be rung on the hour and half hour. 

padding (class Mai^n) 

Specifies the amount of internal padding in pixels to be used. The default is 8. 

font (class Font) 

Specifies the font to be used for the digital clock. Note that variable width fonts 
currently will not always display correctly. 

WIDGETS 

In order to specify resources, it is useful to know the hierarchy of the widgets which compose 
xclock. In the notation below, indentation indicates hierarchical structure. The widget class name 
is given first, followed by the widget instance name. 

XClock xclock 

Clock clock 

ENVIRONMENT 

DISPLAY 

the default host and display number. 

XENVIRONMENT 

the name of a resource file that overrides the global resources stored in the 
RESOURCEMANAGER property. 

FILES 

/usr/lib/Xll/app-defaults/XClock - specifies required resources 

SEE ALSO 

X(l), xrdb(l), time(3C), Athena Clock widget 

BUGS 

Xclock believes the system clock. 

When in digital mode, the string should be centered automatically. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See X{1) for a full statement of rights and permissions. 

AUTHORS 

Tony Delia Fera (MIT-Athena, DEC) 
Dave Mankins (MIT-Athena, BBN) 
Ed Moy(UC Berkeley) 
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NAME 

xcutsel - interchange between cut buffer and selection 

SYNOPSIS 

xcutsel [ -toolkitoption ...] [-selection selection] [-cutbuffer number] 

DESCRIPTION 

T\\& xcutsel program is used to copy the current selection into a cut buffer and to make a selection 
that contains the current contents of the cut buffer. It acts as a bridge between applications that 
don't support selections and those that do. 

By default, xcutsel will use the selection named PRIMARY and the cut buffer CUTBUFFERO. 
Either or both of these can be overridden by command line arguments or by resources. 

An xcutsel window has the following buttons: 

quit When this button is pressed, xcutsel exits. Any selections held by xcutsel are automati- 
cally released. 

copy PRIMARY to 

When this button is pressed, xcutsel copies the current selection into the cut buffer. 

copy to PRIMARY 

When this button is pressed, xcutsel converts the current contents of the cut buffer into 
the selection. 

The button labels reflect the selection and cutbuffer selected by command line options or through 
the resource database. 

When the "copy to PRIMARY" button is activated, the button will remain inverted as long as 
xcutsel remains the owner of the selection. This serves to remind you which client owns the 
current selection. Note that the value of the selection remains constant; if the cutbuffer is 
changed, you must again activate the copy button to retrieve the new value when desired. 

OPTIONS 

Xcutsel accepts all of the standard X Toolkit command line options as well as the following: 

-selection name 

This option specifies the name of the selection to use. The default is PRIMARY. The 
only supported abbreviations for this option are "-select", "-sel" and "-s", as the stan- 
dard toolkit option "-selectionTimeout" has a similar name. 

-cutbuffer number 

This option specifies the cut buffer to use. The default is cut buffer 0. 

X DEFAULTS 

This program accepts all of the standard X Toolkit resource names and classes as well as: 

selection (class Selection) 

This resource specifies the name of the selection to use. The default is PRIMARY. 

cutBuffer (class CutBufTer) 

This resource specifies the number of the cut buffer to use. The default is 0. 

WIDGET NAMES 

The following instance names may be used when user configuration of the labels in them is 
desired: 

sel-cut (class Command) 

This is the "copy SELECTION to BUFFER" button. 

cut-sel (class Command) 

This is the "copy BUFFER to SELECTION" button. 

quit (class Command) 

This is the "quit" button. 

SEE ALSO 

X(l), xclipboard(l), xterm(l), text widget documentation, individual client documentation for how 
to make a selection. 
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BUGS 

There is no way to change the name of the selection or the number of the cut buffer while the pro- 
gram is running. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technolosr 
See^(i) for a full statement of rights and permissions. 

AUTHOR 

Ralph R Swick, DEC/MIT Project Athena 
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NAME 

xdm - X Display Manager 

SYNOPSIS 

xdm [-config configuration Jile\ [-daemon] [-debug debugjevef] [-error error Jogjile] [- 
nodaemon] [-resources resource JUe\ [-server server_entry\ [-session session j)rogfam\ [-xrm 
resource jpecificadon] 

DESCRIPTION 

Xdm manages a collection of X displays, both local and possibly remote - the emergence of X 
terminals guided the design of several parts of this system, along with the development of the X 
Consortium standard XDMCP, the X Display Manager Control Protocol). It is designed to provide 
services similar to that provided by init, getty and login on character terminals: prompting for 
login/password, authenticating the user and running a "session". 

A "session" is defined by the lifetime of a particular process; in the traditional character-based 
terminal world, it is the user's login shell process. In the xdm context, it is an arbitrary session 
manager. This is because in a windowing environment, a user's login shell process would not 
necessarily have any terminal-like interface with which to connect. 

Until real session managers become widely available, the typical xdm substitute would be either a 
window manager with an exit option, or a terminal emulator running a shell - with the condition 
that the lifetime of the terminal emulator is the lifetime of the shell process that it is running - thus 
degenerating the X session to an emulation of the character-based terminal session. 

When the session is terminated, xdm resets the X server and (optionally) restarts the whole pro- 
cess. 

Because xdm provides the first interface that users will see, it is designed to be simple to use and 
easy to customize to the needs of a particular site. Xdm has many options, most of which have 
reasonable defaults. Browse through the various sections, picking and choosing the things you 
want to change. Pay particular attention to the Xsession section, which will describe how to set up 
the style of session desired. 

OPTIONS 

First, note that all of these options, except -config, specify values which can also be specified in the 
configuration file as resources. 

-config configuration Jile 

Specifies a resource file which specifies the remaining configuration parameters. If no 
file is specified and the file /usr/lib/Xll/xdm/xdm-config exists, xdm will use it. 

-daemon 

Specifies "true" as the value for the DisplayManagendaemonMode resource. This makes 
xdm close all file descriptors, disassociate the controlling terminal and put itself in the 
background when it first starts up (just like the host of other daemons). It is the default 
behavior. 

-debug debug Jevel 

Specifies the numeric value for the DispIayManager.debugLevel resource. A non-zero 
value causes xdm to print piles of debugging statements to the terminal; it also disables 
the DisplayManager.daemonMode resource, forcing xdm to run synchronously. To inter- 
pret these debugging messages, a copy of the source code for xdm is almost a necessity. 
No attempt has been made to rationalize or standardize the output. 

-error error Jog Jile 

Specifies the value for the DisplayManagenerrorLogFile resource. This file contains 
errors from xdm as well as anything written to stderr by the various scripts and programs 
run during the progress of the session. 

-nodaemon 

Specifies "false" as the value for the DisplayManager^aemonMode resource. 

-resources resource Jile 

Specifies the value for the DisplayManager*resources resource. This file is loaded using 
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xrdb (1) to specify configuration parameters for the authentication widget. 

-server server _entry 

Specifies the value for the DispIayManagenservers resource. See the section below which 
describes this resource in depth. 

-udpPort portjtumber 

Specifies the value for the DisplayManager.requestPort resource. This sets the port- 
number which XDM will monitor for XDMCP requests. As XDMCP uses the registered 
well-known udp port 177, this resource should probably not be changed except for debug- 
ging- 

-session session _progfam 

Specifies the value for the DispIayManager*session resource. This indicates the program 
to run when the user has logged in as the session. 

-xrm resource jpecification 

This allows an arbitrary resource to be specified, just as most toolkit applications. 

RESOURCES 

At many stages the actions of xdm can be controlled through the use of the configuration file, 
which is in the familiar X resource format. See Jim Fulton's article on resource files 
{doc /tutorials /resources. txi) for a description of the format. Some resources modify the behavior 
of xdm on all displays, while others modify its behavior on one single display. Where actions 
relate to a specific display, the display name is inserted into the resource name between "Display- 
Manager" and the final resource name segment. For example, DisplayManagene^^K) 0.startup is 
the name of the resource which defines the startup shell file on the "expo:0" display. Because the 
resource manager uses colons to separate the name of the resource from its value and dots to 
separate resource name parts, xdm substitutes underscores for the dots and colons when generat- 
ing the resource name. 

DisplayManagenservers 

This resource either specifies a file name full of server entries, one per line (if the value 
starts with a slash), or a single server entry. Each entry indicates a displays which should 
constantly be managed and which is not using XDMCP. Each entry consists of at least 
three parts: a display name, a display class, a display type, and (for local servers) a com- 
mand line to start the server. A typical entry for local display number would be: 

:0 Digital-QV local /usr/bin/Xll/X :0 

The display types are: 

local a local display, i.e. one which has a server program to run 

foreign a remote display, i.e. one which has no server program to run 

The display name must be something that can be passed in the -display option to any X 
program. This string is used in the display-specific resources to specify the particular 
display, so be careful to match the names (e.g. use ":0 local /usr/bin/Xll/X :0" instead of 
nocalhost:0 local /usr/bin/Xll/X :0'' if your other resources are specified as 
'DisplayManager._0.session"). The display class portion is also used in the display- 
specific resources, as the class portion of the resource. This is useful if you have a large 
collection of similar displays (like a corral of X terminals) and would like to set resources 
for groups of them. When using XDMCP, the display is required to specify the display 
class, so perhaps your X terminal documentation describes a reasonably standard display 
class string for your device. 

DispIayManagenrequestPort 

This indicates the UDP port number which xdm uses to listen for incoming XDMCP 
requests. Unless you need to debug the system, leave this with it's default value of 177. 

DispiayManagenerrorLogFile 

Error output is normally directed at the system console. To redirect it simply set this 
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resource to any file name. A method to send these messages to syslog should be 
developed for systems which support it; however the wide variety of "standard" interfaces 
precludes any system-independent implementation. This file also contains any output 
directed to stderr by Xstartup, Xsession andXreset, so it will contain descriptions of prob- 
lems in those scripts as well. 

DispIayManager.debugLevel 

A non-zero value specified for this integer resource will enable reams of debugging infor- 
mation to be printed. It also disables daemon mode which would redirect the information 
into the bit-bucket. Specifying a non-zero debug level also allows non-root users to run 
xdm which would normally not be useful. 

DisplayManagendaemonMode 

Normally, xdm attempts to make itself into an unassociated daemon process. This is 
accomplished by forking and leaving the parent process to exit, then closing file descrip- 
tors and mangling the controlling terminal. When attempting to 6dovigxdm , this is quite 
bothersome. Setting this resource to "false" will disable this feature. 

DisplayManagenpidFile 

The filename specified will be created to contain an ascii representation of the process-id 
of the main xdm process. This is quite useful when reinitializing the system. Xdm also 
uses file locking to attempt to eliminate multiple daemons running on the same machine, 
which would cause quite a bit of havoc. 

DisplayManagenlockPidFile 

This is the resource which controls whether xdm uses file locking to keep multiple xdms 
from running amok. On SYSV, this uses the lockf library call, while on BSD it uses fk)ck. 
The default value is "true". 

DisplayManagenremoteAuthDir 

This is a directory name which xdm uses to temporarily store authorization files for 
displays using XDMCP. The default value is /usr/lib/Xll/xdm. 

DisplayMaiiager.autoRescan 

This boolean controls whether xdm rescans the configuration file and servers file after a 
session terminates and the files have changed. By default it is "true". You can iotctxdm 
to reread these files by sending a SIGHUP to the main process. 

DisplayManager.removeDomainname 

When computing the display name for XDMCP clients, the resolver will typically create a 
fully qualified host name for the terminal. As this is sometimes confusing, xdm will 
remove the domain name portion of the host name if it is the same as the domain name 
for the local host when this variable is set. By default the value is "true". 

DisplayManagenkeyFile 

XDM-AUTHENTICATION-l style XDMCP authentication requires that a private key be 
shared between xdm and the terminal. This resource specifies the file containing those 
values. Each entry in the file consists of a display name and the shared key. By default, 
xdm does not include support for XDM-AUTHENTICATION-l as it requires DES 
which is not generally distributable. 

DisplayManager.DISPLAY.resources 

This resource specifies the name of the file to be loaded by xrdb (1) as the resource data- 
base onto the root window of screen of the display. This resource data base is loaded 
just before the authentication procedure is started, so it can control the appearance of the 
"login" window. See the section below on the authentication widget which describes the 
various resources which are appropriate to place in this file. There is no default value for 
this resource, but the conventional name is /usr/lib/Xll/xdm/Xresources. 

DispIayMaiiager.DISPIAY.xrdb 

Specifies the program used to load the resources. By default, xdm uses 
/usr/bin/Xll/xrdb. 
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DisplayManager.DISPLAY.cpp 

This specifies the name of the C preprocessor which is used by xrdb. 

DisplayManager.DISPLAY.startup 

This specifies a program which is run (as root) after the authentication process succeeds. 
By default, no program is run. The conventional name for a file used here is Xstartup. 
See the Xstartup section below. 

DisplayManager.DISPLAY.session 

This specifies the session to be executed (not running as root). By default, 
/usr/bin/Xll/xterm is run. The conventional name is Xsession. See the Xsession session 
below. 

DisplayManager.DISPLAY.reset 

This specifies a program which is run (as root) after the session terminates. Again, by 
default no program is run. The conventional name is Xreset. See the Xreset section 
further on in this document. 

DispIayManager.DISPLAY.openDelay 

DisplayMaiiager.DISPLAY.openRepeat 

DisplayManager.DISPLAY.opeifrimeout 

DisplayManager.DISPLAY.startAttempts 

These numeric resources control the behavior oixdm when attempting to open intransi- 
gent servers. openDelay is the length of the pause (in seconds) between successive 
attempts, openRepeat is the number of attempts to make, openTimeout is the amount of 
time to wait while actually attempting the open (i.e. the maximum time spent in the con- 
nect (2) syscall) and startAttempts is the number of times this entire process is done 
before giving up on the server. After openRepeat attempts have been made, or if open- 
Timeout seconds elapse in any particular attempt, xdm terminates and restarts the server, 
attempting to connect again, this process is repeated startAttempts time, at which point 
the display is declared dead and disabled. Although this behavior may seem arbitrary, it 
has been empirically developed and works quite well on most systems. The default values 
are 5 for openDelay, 5 for openRepeat, 30 for openTimeout and 4 for startAttempts. 

DispIayManager.DISPLAY.pingInterval 

DispIayManager.DISPLAY.pin^imeout 

To discover when remote displays disappear, xdm occasionally "^ings" them, using an X 
connection and sending XSync requests, pinglnterval specifies the time (in minutes) 
between each ping attempt, pin^imeout specifies the maximum amount of time (in 
minutes) to wait for the terminal to respond to the request. If the terminal does not 
respond, the session is declared dead and terminated. By default, both are set to 5 
minutes, xdm will not ping local displays. Although it would seem harmless, it is 
unpleasant when the workstation session is terminated as a result of the server hanging 
for NFS service and not responding to the ping. 

DispIayManager.DISPLAY.tenninateServer 

This boolean resource specifies whether the X server should be terminated when a ses- 
sion terminates (instead of resetting it). This option can be used when the server tends to 
grow without bound over time in order to limit the amount of time the server is run. The 
default value is "FALSE". 

DisplayManager.DISPIAY.userPath 

Xdm sets the PATH environment variable for the session to this value. It should be a 
colon separated list of directories, see sh{l) for a full description. The default value can 
be specified in the X system configuration file with DefUserPath, frequently it is set to 
":/bin:/usr/bin:/usr/bin/Xll:/usr/ucb". 

DispIayManager.DISPLAY.systemPath 

Xdm sets the PATH environment variable for the startup and reset scripts to the value of 
this resource. The default for this resource is specified with the DefaultSystemPath entry 
in the system configuration file, but it is frequently 
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"/etc:/bin:/usr/bin:/usr/bin/Xll:/usr/ucb''. Note the conspicuous absence of "." from 
this entry. This is a good practise to follow for root; it avoids many common trojan horse 
system penetration schemes. 

DisplayManager.DISPIAY.systemShell 

Xdm sets the SHELL environment variable for the startup and reset scripts to the value of 
this resource. By default, it is "/bin/sh". 

DispIayManager.DISPLAY.failsafeClient 

If the default session fails to execute, xdm will fall back to this program. This program is 
executed with no arguments, but executes using the same environment variables as the 
session would have had (see the section "Xsession" below). By default, 
/usr/bin/Xll/xterm is used. 

DisplayManager.DISPLAY.grabServer 

DispIayManager.DISPLAY.grabTimeout 

To eliminate obvious security shortcomings in the X protocol, xdm grabs the server and 
keyboard while reading the name/password. The grabServer resource specifies if the 
server should be held for the duration of the name/password reading, when FALSE, the 
server is ungrabbed after the keyboard grab succeeds, otherwise the server is grabbed 
until just before the session begins. The grabTimeout resource specifies the maximum 
time xdm will wait for the grab to succeed. The grab may fail if some other client has the 
server grabbed, or possibly if the network latencies are very high. This resource has a 
default value of 3 seconds; you should be cautious when raising it as a user can be 
spoofed by a look-alike window on the display. If the grab fails, xdm kills and restarts the 
server (if possible) and session. 

DisplayManager.DISPIAY.authorize 

DispIayManager.DISPLAY.authName 

authorize is a boolean resource which controls whether xdm generates and uses authori- 
zation for the server connections. If authorization is used, authName specifies the type to 
use. Currently, xdm supports only MIT-MAGIC-COOKIE-l authorization, XDM- 
AUTHORIZATION-1 could be supported as well, but DES is not generally distributable. 
XDMCP connections specify which authorization types are supported dynamically, so 
authName is ignored in this case. When authorize is set for a display and authorization is 
not available, the user is informed by having a different message displayed in the login 
widget. By default, authorize is "true"; authName is "MIT-MAGIC-COOKIE-l". 

DisplayManager.DISPLAY.authFile 

This file is used to communicate the authorization data from xdm to the server, using the 
-auth server command line option. It should be kept in a directory which is not world- 
writable as it could easily be removed, disabling the authorization mechanism in the 
server. 

DisplayManager.DISPIAY.resetForAuth 

The original implementation of authorization in the sample server reread the authoriza- 
tion file at server reset time, instead of when checking the initial connection. As xdm gen- 
erates the authorization information just before connecting to the display, an old server 
would not get up-to-date authorization information. This resource causes xdm to send 
SIGHUP to the server after setting up the file, causing an additional server reset to occur, 
during which time the new authorization information will be read 

DisplayManager.DISPIAY.userAuthDir 

When xdm is unable to write to the usual user authorization file ($HOME/.Xauthority), it 
creates a unique file name in this directory and points the environment variable XAU- 
THORITY at the created file. By default it uses "/tmp". 

CONTROLLING THE SERVER 

Xdm controls local servers using POSIX signals. SIGHUP is expected to reset the server, closing 
all client connections and performing other clean up duties. SIGTERM is expected to terminate 
the server. If these signals do not perform the expected actions, xdm will not perform properly. 
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To control remote servers not using XDMCP, xdm searches the window hierarchy on the display 
and uses the protocol request KillClient in an attempt to clean up the terminal for the next ses- 
sion. This may not actually kill all of the clients, as only those which have created windows will be 
noticed. XDMCP provides a more sure mechanism; when xdm closes it's initial connection, the 
session is over and the terminal is required to close all other connections. 

CONTROLLING XDM 

Xdm responds to two signals: SIGHUP and SIGTERM. When sent a SIGHUP, xdm rereads the 
configuration file and the Ifile specified by the DispIayManagenservers resource and notices if 
entries have been added or removed. If a new entry has been added, xdm starts a session on the 
associated display. Entries which have been removed are disabled immediately, meaning that any 
session in progress will be terminated without notice, and no new session will be started. 

When sent a SIGTERM, xdm terminates all sessions in progress and exits. This can be used when 
shutting down the system. 

Xdm attempts to mark the various sub-processes for ps(l) by editing the command line argument 
list in place. Because xdm can't allocate additional space for this task, it is useful to start xdm with 
a reasonably long command line (15 to 20 characters should be enough). Each process which is 
servicing a display is marked "-< Display-Name >". 

AUTHENTICATION WIDGET 

The authentication widget is an application which reads a name/password pair from the keyboard. 
As this is a toolkit client, nearly every imaginable parameter can be controlled with a resource. 
Resources for this widget should be put into the file named by 
DisplayManager.DISPLAY.resources. All of these have reasonable default values, so it is not 
necessary to specify any of them. 

xlogin.Login.width, xIogin.Login.height, xIogin.Login.x, xlogin.Login.y 

The geometry of the login widget is normally computed automatically. If you wish to posi- 
tion it elsewhere, specify each of these resources. 

xlogin.Login.foreground 

The color used to display the typed-in user name. 

xIogin.Login.font 

The font used to display the typed-in user name. 

xlogin.Login.greeting 

A string which identifies this window. The default is "Welcome to the X Window System". 

xIogin.Login.unsecureGreeting 

When X authorization is requested in the configuration file for this display and none is in 
use, this greeting replaces the standard greeting. It's default value is "This is an unsecure 
session" 

xIogin.Login.greetFont 

The font used to display the greeting. 

xlogin.Login.greetColor 

The color used to display the greeting. 

xlogin.Login.namePrompt 

The string displayed to prompt for a user name. Xrdb strips trailing white space from 
resource values, so to add spaces at the end of the prompt (usually a nice thing), add 
spaces escaped with backslashes. The default is "Login: " 

xIogin.Login.passwdPrompt 

The string displayed to prompt for a password. The default is Tassword: ". 

xIogin.Login.promptFont 

The font used to display both prompts. 

xlogin.Login.promptCoIor 

The color used to display both prompts. 
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xlogin.Login.fail 

A message which is displayed when the authentication fails. The default is "Login Failed, 
please try again". 

xlogin.Login.failFont 

The font used to display the failure message. 

xlogin.Login.failCoIor 

The color used to display the failure message. 

xlogin.Login.feilTimeout 

The time (in seconds) that the fail message is displayed. The default is 30 seconds. 

xlogin.Login.translations 

This specifies the translations used for the login widget. Refer to the X Toolkit documen- 
tation for a complete discussion on translations. The default translation table is: 

Ctrl < Key > H: delete-previous-characterQ \n\ 

Ctrl < Key > D: delete-characterQ \n\ 

Ctrl < Key > B: move-backward-character() \n\ 

Ctrl < Key >F: move-forward-character() \n\ 

Ctrl < Key > A: move-to-begining() \n\ 

Ctrl < Key > E: move-to-end() \n\ 

Ctrl < Key > K: erase-to-end-of-line() \n\ 

Ctrl < Key > U: erase-line() \n\ 

Ctrl < Key > X: erase-lineQ \n\ 

Ctrl < Key > C: restart-session() \n\ 

Ctrl < Key > \\: abort-session() \n\ 

< Key > Backspace: delete-previous-character() \n\ 

< Key > Delete: delete-previous-characterQ \n\ 

< Key > Return: f inish-f ieldQ \n\ 

< Key > : insert-charQ \ 

The actions which are supported by the widget are: 

delete-previous-character 

Erases the character before the cursor. 

delete-character 

Erases the character after the cursor. 

move-backward-character 

Moves the cursor backward. 

move-forward-character 

Moves the cursor forward. 

move-to-begining 

(Apologies about the spelling error.) Moves the cursor to the beginning of the editable 
text. 

move-to-end 

Moves the cursor to the end of the editable text. 

erase-to-end-of-line 

Erases all text after the cursor. 

erase-line 

Erases the entire text. 

fmish-field 

If the cursor is in the name field, proceeds to the password field; if the cursor is in the 
password field, check the current name/password pair. If the name/password pair are 
valid, xdm starts the session. Otherwise the failure message is displayed and the user is 
prompted to try again. 
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abort-session 

Terminates and restarts the server. 

abort-display 

Terminates the server, disabhng it. This is a rash action and is not accessible in the 
default configuration. It can be used to stop xdm when shutting the system down, or 
when using xdmshell. 

restart-session 

Resets the X server and starts a new session. This can be used when the resources have 
been changed and you want to test them, or when the screen has been overwritten with 
system messages. 

insert-char 

Inserts the character typed. 

set-session-argument 

Specifies a single word argument which is passed to the session at startup. See the sec- 
tions on Xsession and Typical usage. 

allow-all-access 

Disables access control in the server, this can be used when the .Xauthority file cannot be 
created by xdm. Be very careful using this, it might be better to disconnect the machine 
from the network before doing this. 

The Xstartup fik 

This file is typically a shell script. It is run as "root" and should be very careful about security. 
This is the place to put commands which make fake entries in /etc/utmp, mount users' home 
directories from file servers, display the message of the day, or abort the session if logins are not 
allowed. Various environment variables are set for the use of this script: 

DISPLAY is set to the associated display name 

HOME is set to the home directory of the user 

USER is set to the user name 

PATH is set to the value of DispIayManager.DISPIAY.systemPath 

SHELL is set to the value of DisplayManager.DISPLAY.systemShell 

XAUTHORITY may be set to an authority file 

No arguments of any kind are passed to the script. Xdm waits until this script exits before starting 
the user session. If the exit value of this script is non-zero, xdm discontinues the session immedi- 
ately and starts another authentication cycle. 

The Xsession program 

This is the command which is run as the user's session. It is run with the permissions of the 
authorized user, and has several environment variables specified: 

DISPLAY is set to the associated display name 

HOME is set to the home directory of the user 

USER is set to the user name 

PATH is set to the value of DisplayManagenDISPLAY.userPath 

SHELL is set to the user's default shell (from /etc/passwd) 

XAUTHORITY may be set to a non-standard authority file 

At most installations, Xsession should look in $HOME for a file jcsession which would contain 
commands that each user would like to use as a session. This would replace the system default 
session. Xsession should also implement the system default session if no user-specified session 
exists. See the section Typical Usage below. 

An argument may be passed to this program from the authentication widget using the 'set- 
session-argument' action. This can be used to select different styles of session. One very good use 
of this feature is to allow the user to escape from the ordinary session when it fails. This would 
allow users to repair their own jcsession if it fails, without requiring administrative intervention. 
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The section on typical usage demonstrates this feature. 

The Xreset flk 

Symmetrical with Xstartup, this script is run after the user session has terminated. Run as root, it 
should probably contain commands that undo the effects of commands in Xstartup, removing fake 
entries from /etc/utmp or unmounting directories from file servers. The collection of environ- 
ment variables that were passed io Xstartup are also given Xo Xreset. 

lypkal Usage 

Actually, xdm is designed to operate in such a wide variety of environments that "typical" is prob- 
ably a misnomer. However, this section will focus on making xdm a superior solution to tradi- 
tional means of starting X from /etc/ttys or manually. 

First off, the xdm configuration file should be set up. A good thing to do is to make a directory 
{/usr/lib /Xll /xdm comes immediately to mind) which will contain all of the relevant files. Here 
is a reasonable configuration file, which could be named xdm-config : 

DisplayManager.servers: /usr/lib/Xl 1/xdm/Xservers 

DisplayManager.errorlvOgFile: /usr/lib/Xl 1/xdm/xdm-errors 

DisplayManager.pidFile: /usr/lib/Xll/xdm/xdm-pid 

DisplayManager*resources: /usr/lib/Xl 1/xdm/Xresources 

DisplayManager*session: /usr/lib/Xll/xdm/Xsession 

DisplayManager._0.authorize: true 

DisplayManager*authorize: false 

As you can see, this file simply contains references to other files. Note that some of the resources 
are specified with "*" separating the components. These resources can be made unique for each 
different display, by replacing the "*" with the display-name, but normally this is not very useful. 
See the Resources section for a complete discussion. 

The first file /usr/lib/Xll/xdm/Xservers contains the list of displays to manage. Most worksta- 
tions have only one display, numbered 0, so the file will look like this: 

:0 Local local /usr/bin/Xll/X :0 

This will keep /usr/bin/Xll/X running on this display and manage a continuous cycle of sessions. 

The file /usr/lib/XU/xdm/xdm-errors will contain error messages from xdm and anything output 
to stderr hy Xstartup, Xsession or Xreset. When you have trouble getting xrfm working, check this 
file to see iixdm has any clues to the trouble. 

The next configuration entry, /usr/Ub/Xll/xdm/Xresources, is loaded onto the display as a 
resource database using xrdb (1). As the authentication widget reads this database before starting 
up, it usually contains parameters for that widget: 

xlogin*login.translations: #overrJde\ 

<Key>Fl: set-session-argument(failsafe) finish-field()\n\ 
< Key > Return: set-session-argument() finish-fieldQ 

xlogin*borderWidth: 3 

#ifdef COLOR 

xlogin*greetColor: #f63 

xlogin*failColor: red 

xlogin*Foreground: black 

xlogin*Background: #fdc 

#else 

xlogin*Foreground: black 

xlogin*Background: white 

#endif 
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The various colors specified here look reasonable on several of the displa)^ we have, but may look 
awful on other monitors. As X does not currently have any standard color naming scheme, you 
might need to tune these entries to avoid disgusting results. Please note the translations entry; it 
specifies a few new translations for the widget which allow users to escape from the default session 
(and avoid troubles that may occur in it); Note that if #override is not specified, the default trans- 
lations are removed and replaced by the new value, not a very useful result as some of the default 
translations are quite useful (like "<Key>: insert-char ()" which responds to normal typing). 

The Xstartup file used here simply prevents login while the file /etc/nolog^n exists. As there is no 
provision for displaying any messages here (there isn't any core X client which displays files), the 
user will probably be baffled by this behavior. I don't offer this as a complete example, but simply 
a demonstration of the available functionality. 

Here is a sample Xstartup script: 

#!/bin/sh 
# 

# Xstartup 
# 

# This program is run as root after the user is verified 
# 

if [ -f /etc/nologin ]; then 

exit 1 
fi 
exitO 

The most interesting script is Xsession. This version recognizes the special "failsafe" mode, 
specified in the translations in the Xresources file above, to provide an escape from the ordinary 
session: 

#!/bin/sh 
# 

# Xsession 
# 

# This is the program that is run as the client 

# for the display manager. This example is 

# quite friendly as it attempts to run a per-user 

# .xsession file instead of forcing a particular 

# session layout 
# 

case $# in 

1) 

case $1 in 
failsafe) 

exec xterm -geometry 80x24-0-0 -Is 



startup = $HOME/.xsession 
resources = $HOME/.Xresources 

if [ -f $startup ]; then 

exec $startup 

exec /bin/sh $startup 
else 

if [ -f $resources ]; then 

xrdb -load $resources 
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fi 

twm & 

exec xterm -geometry 80x24 + 10+10 -Is 



NoXreset script is necessary, so none is provided. 

SOME OTHER POSSIBILITIES 

You can also use xdm to run a single session at a time, using the 4.3 init options or other suitable 
daemon by specifying the server on the command line: 

xdm -server ":0 SUN-3/60CG4 local /usr/bin/X lO" 

Or, you might have a file server and a collection of X terminals. The configuration for this could 
look identical to the sample above, except the Xservers file might look like: 

extol:0 VISUAL-19 foreign 

exalt:0 NCD-19 foreign 

explode:0 NCR-TOWERVIEW3000 foreign 

This would direct xdm to manage sessions on all three of these terminals. See the section "Con- 
trolling Xdm" above for a description of using signals to enable and disable these terminals in a 
manner reminiscent of init(8). 

One thing that xdm isn't very good at doing is coexisting with other window systems. To use multi- 
ple window systems on the same hardware, you'll probably be more interested in xinit . 

SEE ALSO 

X(l), xinit(l) and XDMCP 

BUGS 
COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technolo^. 
S&&X(l) for a full statement of rights and permissions. 

AUTHOR 

Keith Packard, MIT X Consortium 
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NAME 

Xdomain - X Window System server for Domain/ OS 

SYNOPSIS 

Xdomain •.displaynumber [option] ttyname 

DESCRIPTION 

X is the window system server. The displaynumber argument is used by clients in their DISPLAY 
environment variable to indicate which server to contact (large machines may have several displays 
attached). This number can be any number, but there can't be more than 4 of them. If no number 
is specified, is used. This number is also used in determining the names of various startup files. 
The ttyname argument is passed in by ink and isn't used. 

When the server starts up, it takes over the display. If you are running on a workstation whose 
console is the display, you cannot log into the console while the server is running. 

The Hewlett-Packard server has support for the following protocols: 

TCP/IP 

The server listens on port htons(6000+N), where N is the display number. 

Local IPC Mechanism 

OPTIONS 

The following options can be given on the command line: 

-a number 

sets pointer acceleration (i.e. the ratio of how much is reported to how much the user 
actually moved the pointer). 

-auth authorization-file 

Specifies a file which contains a collection of authorization records used to authenticate 
access. 

be disables certain kinds of error checking, for bug compatibility with previous releases 

(e.g., to work around bugs in R2 and R3 xterms and toolkits). Deprecated. 

-bs disables backing store support on all screens. 

-c turns off key-click. 

c volume 

sets key-click volume (allowable range: 0-100). 

-co filename 

sets name of RGB color database. 

-dpi resolution 

sets the resolution of the screen, in dots per inch. To be used when the server cannot 
determine the screen size from the hardware. 

•i volume 

sets feep (bell) volume (allowable range: 0-100). 

-fc cursorFont 

sets default cursor font. 

-tnfont sets the default font. 

-fp fontPath 

sets the search path for fonts. This path is a comma separated list of directories which 
the sample server searches for font databases. 

-help prints a usage message. 

-I causes all remaining command line arguments to be ignored. 

-Id kilobytes 

sets the data space limit of the server to the specified number of kilobytes. The default 
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value is zero, making the data size as large as possible. A value of -1 leaves the data 
space limit unchanged. 

-Is kilobytes 

sets the stack space limit of the server to the specified number of kilobytes. The default 
value is zero, making the stack size as large as possible. A value of -1 leaves the stack 
space limit unchanged. 

-logo turns on the X Window System logo display in the screen-saver. There is currently no 
way to change this from a client. This is the default. 

nologo turns off the X Window System logo display in the screen-saver. There is currently no 
way to change this from a client. 

■^ minutes 

sets screen-saver pattern cycle time in minutes. 

-r turns ofif auto-repeat. 

r turns on auto-repeat. 

-s minutes 

sets screen-saver timeout time in minutes. 

-su disables save under support on all screens. 

-t number 

sets pointer acceleration threshold in pixels (i.e. after how many pixels pointer accelera- 
tion should take effect). 

-tenninate 

If the server ever recycles (all the clients die or the server gets a SIGHUP), the server 
will exit. 

-to seconds 

sets default connection timeout in seconds. 

ttjacc ignored, for servers started the ancient way (from init). 

V sets video-on screen-saver preference to screen blanking. This is the default. 

-V sets video-off screen-saver preference to a bouncing X logo. 

-wm forces the default backing-store of all windows to be WhenMapped; a way of getting 
backing-store to apply to all windows. 

-X extension 

loads the specified extension at runtime. Not supported. 

noborrow 

Inhibit borrow mode. When this flag is used, the borrow mode mechanism can not be 
used - the borrow hot key and signals are ignored. Useful if running the server from init 
and the DM will never be run. 

You can also have the X server connect to xdm using XDMCP. Although this is not typically use- 
ful as it doesn't allow xdm to manage the server process, it can be used to debug XDMCP imple- 
mentations, and serves as a sample implementation of the server side of XDMCP. The following 
options control the behavior of XDMCP. 

-query host-name 

Enable XDMCP and send Query packets to the specified host. 

-broadcast 

Enable XDMCP and broadcast BroadcastQuery packets to the network. The first 
responding display manager will be chosen for the session. 

-indirect host-name 

Enable XDMCP and send IndirectQuery packets to the specified host. 

-port/)ort-«M/n 

Use an alternate port number for XDMCP packets. Must be specified before any 
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-query, -broadcast or -indirect options. 

•once Normally, the server keeps starting sessions, one after the other. This option makes the 
server exit after the first session is over. 

-class display-class 

XDMCP has an additional display qualifier used in resource lookup for display-specific 
options. This option sets that value, by default it is "MIT-Unspecified" (not a very useful 
value). 

-displaylD display-id 

Yet another XDMCP specific value, this one allows the display manager to identify each 
display so that it can locate the shared key. 

RUNNING FROM INIT 

It is possible to run Xdomain, instead of the Display Manager, when the system boots by modifing 
the configuration file specified for it in /etc/rc. If you just want to use the node as a display server 
and plan to run all clients from anther node, "touch /etc/daemons/Xdomain". (The Display 
Manager is also run in this case unless you tell the system not to (see /etc/rc) - this is usually not a 
problem because things work as you would expect). If you want to run clients on the same node 
as the server, use xdm. xdm provides an environment vaguely similar to the Display Manager. To 
run xdm at boot time, "touch /etc/daemons/xdm". Be sure to configure xdm or you will probably 
be disapointed with the results. 

SECURITY 

X uses an access control list for deciding whether or not to accept a connection from a given client 
This list initially consists of the machine on which the server is running, and any hosts listed in the 
file /etc/X*.hosts (where • is the display number). This file should contain one line per host 
name, with no white space. 

The user can manipulate a dynamic form of this list in the server using the xhost{l) program from 
the same machine as the server. 

Unlike some window systems, X does not have any notion of window operation permissions or 
place any restrictions on what a client can do; if a program can connect to a display, it has full run 
of the screen. 

SIGNALS 

A' will catch the SIGHUP signal sent by init(lM) after the initial process (usually the login termi- 
nal window) started on the display terminates. This signal causes all connections to be closed 
(thereby disowning the terminal), all resources to be freed, and all defaults restored. 

A SIGTERM or SIGINT will cause X to gracefully exit. 

SIGUSRl and SIGUSR2 are used to trigger the borrow mode mechanism. See Borrow Mode. 

Borrow Mode 

Unlike the share mode X server, the borrow mode server can not share the display with the 
Display Manager. However, X and the DM can pass the display, keyboard and mouse back and 
forth. Sending a SIGUSRl signal to X (or pressing Shift Control F9) will cause it to pass the 
display back to the DM. (While X does not have control of the display, recycling and exiting is 
inhibited). Sending a SIGUSR2 signal to A" will cause it to take the display back from the DM. 

You can still talk to the inactive display (manager), you just can't see the results until it is bor- 
rowed back. 

MISCELLANEOUS 

To exit the server, you can press Shift-Control-Exit. This is a bad idea if you ran just the server at 
boot time (you'll have to reboot). OK if xdm ran the server from boot. 
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Domain/OS Only 

The display drivers are loaded at server run time. This means that the drivers will have to be in 
the correct places and a magic incantation recited so the server can find the drivers. This should 
have been done by the process that installed the server. 

Xdomain requires 10.3.2 (and later) Domain/OS, Display Manager, gprlib, awslib and pmlib. 
These were distributed on a 10.3 PSK. 

There are many programs that start the X server and set up an environment (windows, window 
manager, etc). Tliese include xdm. 

DIAGNOSTICS 

Too numerous to list them all. If run boot time, errors are logged in the file /usr/adm/X*msff. 

FILES 

/etc/X*. hosts Initial access control list 

/usr/lib/Xll/fonts/... Font directories 

/usr/lib/Xll/rgb.txt Color database 

/usr/lib/Xll/rgb.pag Color database 

/usr/lib/Xll/rgb.dir Color database 

/usr/adm/X*msgs Error log file 

/usr/lib/Xll/X*devices Input devices used by the server 

/usr/lib/Xll/X*pointerkeys Keyboard pointer device file 

/sys/mgrs.split/.. Directories containing the display drivers 

NOTES 

The option syntax is inconsistent with itself and xset(l). 

The acceleration option should take a numerator and a denominator like the protocol. 

If X dies before its clients, new clients won't be able to connect until all existing connections have 
their TCP TIMEWAIT timers expire. 

The color database is missing a large number of colors. However, there doesn't seem to be a 
better one available that can generate RGB values. 

COPYRIGHT 

Copyright 1988, 1989, Massachusetts Institute of Technology. 
See X(l) for a full statement of rights and permissions. 

ORIGIN 

MIT Distribution 

SEE ALSO 

Xapollo(l), X(l), bdftosnf bitmap(l), getty(lM), gettydefs(4), gwindstop(l), hpterm(l), init(lM), 
inittab(4), rgb(l), uwm(l), xllstart(l), xclock(l), 3rfc(l), xfd(l), xhost(l), xinit(l), xinitcolor- 
map(l), xload(l), xmodmap(l), xrefresh(l), xseethru(l), xset(l), xsetroot(l), xterm(l), 
xwcreate(l), xwd(l), xwdestroy(l), xwininfo(l), xwud(l), Programming With Xlib, Programming 
With the Xt Intrinsics 
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NAME 

xfd - font displayer for X 

SYNOPSIS 

xfd [-options ...] -fh fontname 

OPTIONS 

Xfd accepts all of the standard toolkit command line options along with the additional options 
listed below: 

-in font This option specifies the font to be displayed. 

-box This option indicates that a box outlining the area that would be filled with background 
color by an ImageText request. 

-center This option indicates that each glyph should be centered in its grid. 

-start number 

This option specifies the glyph index of the upper left hand comer of the grid. This is 
used to view characters at arbitrary locations in the font. The default is 0. 

-be color 

This option specifies the color to be used if ImageText boxes are drawn. 

DESCRIPTION 

The xfd utility creates a window containing the name of the font being displayed, a row of com- 
mand buttons, several lines of text for displaying character metrics, and a grid containing one 
glyph per cell. The characters are shown in increasing order from left to right, top to bottom. 
The first character displayed at the top left will be character number unless the -start option has 
been supplied in which case the character with the number given in the -start option will be used. 

The characters are displayed in a grid of boxes, each large enough to hold any single character in 
the font. Each character glyph is drawn using the PolyTextl6 request (used by the Xlib routine 
XDrawStringl6). If the -box option is given, a rectangle will be drawn around each character, 
showing where an ImageTextl6 request (used by the Xlib routine XDrawImageStringl6) would 
cause background color to be displayed. 

The origin of each glyph is normally set so that the character is drawn in the upper left hand 
comer of the grid cell. However, if a glyph has a negative left bearing or an unusually large 
ascent, descent, or right bearing (as is the case with cursor font), some character may not appear in 
their own grid cells. The -center option may be used to force all glyphs to be centered in their 
respective cells. 

All the characters in the font may not fit in the window at once. To see the next page of glyphs, 
press the Next button at the top of the window. To see the previous page, press Prev. To exit xfd, 
press Quit. 

Individual character metrics (index, width, bearings, ascent and descent) can be displayed at the 
top of the window by pressing on the desired character. 

The font name displayed at the top of the window is the full name of the font, as determined by 
the server. See xlsfonts for ways to generate lists of fonts, as well as more detailed summaries of 
their metrics and properties. 

X DEFAULTS 

To be written. 

SEE ALSO 

X(l), xlsfonts(l), xrdb(l) 

BUGS 

The program should skip over pages full of non-existent characters. 

COPYRIGHT 

Copyright 1989, Massachusetts Institute of Technology. 
See X(l) for a full statement of rights and permissions. 

AUTHOR 

Jim Fulton, MIT X Consortium; previous program of the same name by Mark Lillibridge, MIT 
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NAME 

xhost - server access control program for X 

SYNOPSIS 

xhost [[+-]hostnanie ...] 

DESCRIPTION 

The xhost program is used to add and delete hosts to the list of machines that are allowed to make 
connections to the X server. This provides a rudimentary form of privacy control and security. It 
is only sufficient for a workstation (single user) environment, although it does limit the worst 
abuses. Environments which require more sophisticated measures should use the hooks in the 
protocol for passing authentication data to the server. 

The server initially allows network connections only from programs running on the same machine 
or from machines listed in the file /etc/X*.hosts (where * is the display number of the server). 
The xhost program is usually run either from a startup file or interactively to give access to other 
users. 

Hostnames that are followed by two colons (::) are used in checking DECnet connections; all 
other hostnames are used for TCP/IP connections. 

OPTIONS 

Xhost accepts the following command line options described below. For security, the options that 
effect access control may only be run from the same machine as the server. 

[ + ^hostname 

The given hostname (the plus sign is optional) is added to the list of machines that are 
allowed to connect to the X server. 

•hostname 

The given hostname is removed from the list of machines that are allowed to connect to 
the server. Existing connections are not broken, but new connection attempts will be 
denied. Note that the current machine is allowed to be removed; however, further con- 
nections (including attempts to add it back) will not be permitted. Resetting the server 
(thereby breaking all connections) is the only way to allow local connections again. 

+ Access is granted to everyone, even if they aren't on the list of allowed hosts (i.e. access 

control is turned off). 

Access is restricted to only those machines on the list of allowed hosts (i.e. access control 
is turned on). 

nothing If no command line arguments are given, the list of hosts that are allowed to connect is 
printed on the standard output along with a message indicating whether or not access 
control is currently enabled. This is the only option that may be used from machines 
other than the one on which the server is running. 

FILES 

/etc/X* .hosts 

SEE ALSO 

X(l), Xserver(l) 

ENVIRONMENT 

DISPLAY 

to get the default host and display to use. 

BUGS 

You can't specify a display on the command line because -display is a valid command line argu- 
ment (indicating that you want to remove the machine named "display" from the access list). 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See X(l) for a full statement of rights and permissions. 

AUTHORS 

Bob Scheifler, MIT Laboratory for Computer Science, 
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Jim Gettys, MIT Project Athena (DEC). 
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NAME 

xinit - X Window System initializer 

SYNOPSIS 

xinit [[client] options] [— [server] [display] options] 

DESCRIPTION 

The xinit program is used to start the X Window System server and a first client program (usually 
a terminal emulator) on systems that cannot start X directly from /etc/init or in environments that 
use multiple window systems. When this first client exits, xinit will kill the X server and then ter- 
minate. 

Unless otherwise specified on the command line, xinit sets $DISPLAY to hostnameiO.O, and 
exports it. hostname is the name of the system invoking ja/iiY as returned by gethostname(2). 

If no specific client program is given on the command line, xinit will look for a file in the user's 
home directory called jdnitrc to run as a shell script to start up client programs. If no such file 
exists, xinit will use the following as a default: 

xterm -geometry + 1 + 1 -n login 

If no specific server program is given on the command line, xinit will look for a file in the user's 
home directory called jcseiverrc to run as a shell script to start up the server. If no such file exists, 
xinit will use the following as a default: 

X:0 

Note that this assumes that there is a program named X in the current search path. However, 
servers are usually named Xdisplaytype where displaytype is the type of graphics display which is 
driven by this server. The site administrator should, therefore, make a link to the appropriate type 
of server on the machine, or create a shell script that runs xinit with the appropriate server. 

An important point is that programs which are run by jdnitrc and by jcservenv should be run in the 
background if they do not exit right away, so that they don't prevent other programs from starting 
up. However, the last long-lived program started (usually a window manager or terminal emula- 
tor) should be left in the foreground so that the script won't exit (which indicates that the user is 
done and that xinit should exit). 

An alternate client and/or server may be specified on the command line. The desired client pro- 
gram and its arguments should be given as the first command line arguments to xinit. To specify a 
particular server command line, append a double dash (~) to the xinit command line (after any 
client and arguments) followed by the desired server command. 

Both the client program name and the server program name must begin with a slash (/) or a 
period (.). Otherwise, they are treated as an arguments to be appended to their respective startup 
lines. This makes it possible to add arguments (for example, foreground and background colors) 
without having to retype the whole command line. 

If an explicit server name is not given and the first argument following the double dash (— ) is a 
colon followed by a digit, xinit will use that number as the display number instead of zero and will 
incorporate it into the $DISPLAY environment variable. All remaining arguments are appended 
to the server command line. 

EXAMPLES 

Below are several examples of how command line arguments in xinit ate used. 

xinit This will start up a server named X ifjcserverrc doesn't exist, and run the user's jdnitrc, if 
it exists, or else start an xterm. 

xinit ~ /usr/bin/Xll/Xqdss :1 

This is how one could start a specific type of server on an alternate display. 

xinit -geometry =80x65+10+10 -fn 8x13 -j -tg white -bg navy 

This will start up a server named X, if jcservenv doesn't exist, and will append the given 
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arguments to the default xterm command. It will ignore Mnitrc. 

xinit -e widgets - ./Xsun -1 < 

This will use the command ./Xsun -/ -c to start the server and will append the arguments 
-e widgets to the default A*em» command. 

xinit remsh fasthost cpupig -display ws:l - :1 -a 2 -t 5 

This will start a server named X on display 1 with the arguments -a 2 -t 5. It will then 
start a remote shell on the machine fasthost in which it will run the command cpupig, tel- 
ling it to display back on the local workstation. 

Below is a sample jdnitrc that starts a clock, several terminals, and leaves the window manager 
running as the "last" application. Assuming that the window manager has been configured prop- 
erly, the user then chooses the "Exit" menu item to shut down X. 



xrdb -load $HOME/.Xres 

xsetroot -solid gray & 

xclock -geometry 50x50-0 + -bw & 

xload -geometry 50x50-50+0 -bw & 

xterm -geometry 80x24+0 + & 

xterm -geometry 80x24+0-0 & 

mwm 



Sites that want to create a common startup environment could simply create a default jcinitrc that 
references a site-wide startup file: 

#!/bin/sh 

. /usr/local/lib/site.xinitrc 

Another approach is to write a script that starts xinit with a specific client script. Such xinit startup 
scripts are usually named xll, xstart, xllstart, or startx and are a convenient way to provide a sim- 
ple interface for novice users: 

#!/bin/sh 

xinit $HOME/my.xinitrc ~ /usr/bin/Xll/X :1 

ENVIRONMENT VARIABLES 
DISPLAY 

If not already set, this variable gets set to the name of the display to which clients should 
connect. If already set, the display number is passed to the server. 

XINITRC 

This variable specifies an init file containing shell commands to start up the initial win- 
dows. By default, jdnitrc in the home directory will be used. 

XSERVERC 

This variable specifies an init file containing shell commands to start up the server. By 
default, jcseivenc in the home directory will be used. 

SEE ALSO 

X(l), Xserver(l), xterm(l), xrdb(l), xllstart(l) 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
SeeX(i) for a full statement of rights and permissions. 

ORIGIN 

MIT Distribution 
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NAME 

xinitcolormap - initialize the X colormap 

SYNOPSIS 

xinitcolormap [options] 

DESCRIPTION 

This program is used to initialize the X colormap. Specific X colormap entries (pixel values) are 
made to correspond to specified colors. An initialized colormap is required by applications that 
assume a predefined colormap (e.g., many applications that use Starbase graphics). 

xtnitcolormap reads a colormap file to determine the allocation of colors in the X colormap. The 
name of the colormap file is determined by using (in the following order) the command line 
option [-f colormap file], the .Colormap X default value or jusr flib jXll Ixcolormap. If a colormap 
file is not found, then the following default colormap specification is assumed. 

black (colormap entry 0) 

white 

red 

yellow 

green 

cyan 

blue 

magenta (colormap entry 7) 

xinitcolormap uses the XStoreColor and XAllocColor libXll.a calls to initialize the X colormap. 
The xinitcolormap program should be the first X client program run when the X Window System is 
started in order to assure that X colormap entries have the color associations specified in the 
colormap file. This could be done by running xinitcolormap as the first X client program in the 
jcllstart file. Onct xinitcolormap has been run, an X client program can use the initialized colors. 

A colormap file is made up of lines of the form: 

color 

color is a one or two word color name (refer to the names in the file /usr/lib/Xll /rgb.txt), or 
optionally an initial sharp character followed by a numeric RGB specification (as used by the 
libX.a call XParseColor). The line number of a color specification in the colormap file determines 
the index of the color in the X colormap. Colors in the colormap file, for colormap entry up to 
the last colormap entry to be initialized, must be specified. There should be no extra (blank or 
comment) lines in the colormap file. The first two entries in the colormap file must be black and 
white. Also, a color maybe specified more than once in the colormap file. 

OPTIONS 

4 colormapftle 

Specifies the file containing the colormap. 

-display display 

Specifies the server to connect to; See X(l) for details. 

■c count If count is specified then only the first count colors from the colormap file will be used in 
initializing the X colormap. 

-p If the -p option is specified then the colormap file will be checked for proper syntax, but 

the X colormap will not be initialized. 

-k[ill] If the -k[ill] option is specified, then the colormap entries allocated by a previous run of 
xinitcolormap will be deallocated and the colormap will not be re-initialized. All other 
options will be ignored except -display display. 

NOTES 

xinitcolormap will only initialize the default colormap of the root window. 



Hewlett-Packard Company - 1 - X Window System Release 4 



XINITCOLORMAP(l) XINITCOLORMAP(l) 



xinitcolormap assumes the first two colors specified are black and white. 

xinitcolormap should not be run in the background. The X colormap is fully initialized only when 
xinitcolormap returns. 

KMtmmgxinitcolormap a second time after X is started will deallocate those colors allocated by a 
previous run and attempt to allocate a new colormap using the new specifications. If other clients 
have allocated color cells that conflict with the new specifications, xinitcolormap will fail and the 
colormap will remain un-allocated. 

The file /etc/newconfig/xcolormap is a sample colormap file that corresponds to the Starbase 
default 256 entry colormap. The [-c count] option can be used to select a subset of the colors in 
this colormap file for initializing colormaps with up to 256 entries. 

xinitcolormap uses XSetCloseDownMode with RetainPermanent to prevent the deallocation of the 
colormap. This means that xinitcolormap no longer spawns a daemon, and the only way for the 
user to be sure that xinitcolormap succeeded is to view the messages (or lack of) produced by;a«- 
itcolormap. lixllstart is used, the output should be redirected itom xinitcolormap to a log file. 



FILES 



xinitcolormap will not work on TrueColor visuals. 

/usr/lib/Xll/xcolormap 
/usr/lib/Xll/rgb.txt 
/etc/newconfig/xcolormap 
.xllstart 
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NAME 

xload - load average display for X 

SYNOPSIS 

xload [-toolkitoption ...] [-scale integer] [-update seconds] [-hi color] [-highlight color] 
[-jumpscroU pixels] [-label string\ [-nolabel] 

DESCRIPTION 

The xload program displays a periodically updating histogram of the system load average. 

OPTIONS 

Xload accepts all of the standard X Toolkit command line options (see X(iy). The order of the 
options in unimportant. Xload also accepts the following additional options: 

-hi color or -highlight color 

This option specifies the color of the scale lines. 

-jumpscroll number of pixels 

The number of pixels to shift the graph to the left when the graph reaches the right edge 
of the window. The default value is 1/2 the width of the current window. Smooth scrol- 
ling can be achieved by setting it to 1. 

-label string 

The string to put into the label above the load average. 

-nolabel If this command line option is specified then no label will be displayed above the load 
graph. 

-scale integer 

This option specifies the minimum number of tick marks in the histogram, where one 
division represents one load average point. If the load goes above this number, xload 
will create more divisions, but it will never use fewer than this number. The default is 1. 

■wpAsAe seconds 

This option specifies the frequency in seconds at which xload updates its display. The 
minimum amount of time allowed between updates is 1 second (the default is 5 seconds). 

RESOURCES 

In addition to the resources available to each of the widgets used by xload there is one resource 
defined by the application itself. 

showLabel (class Boolean) 

If False then no label will be displayed. 

WIDGETS 

In order to specify resources, it is useful to know the hierarchy of the widgets which compose 
xload. In the notation below, indentation indicates hierarchical structure. The widget class name 
is given first, followed by the widget instance name. 

XLoad xload 

Paned paned 

Label label 
StripChart load 

ENVIRONMENT 

DISPLAY 

The default host and display number. 

XENVIRONMENT 

The name of a resource file that overrides the global resources stored in the 
RESOURCEMANAGER property. 

FILES 

/usr/lib/Xll/app-defaults/XLoad - specifies required resources 
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SEE ALSO 

X(l), xrdb(l), mem(4), Athena StripChart Widget. 

BUGS 

This program requires the ability to open and read the special system file /dev/kmem. Sites that 
do not allow general access to this file should make x/ooJ belong to the same group as Idevjkmem 
and turn on the set group id permission flag. 

Reading /dev/kmem is inherently non-portable. Therefore, the routine used to read it 
(get_load.c) must be ported to each new operating system. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See X(l) for a full statement of rights and permissions. 

AUTHORS 

K. Shane Hartman (MIT-LCS) and Stuart A. Malone (MIT-LCS); 

with features added by Jim Gettys (MIT-Athena), Bob Scheifler (MIT-LCS), Tony Delia Fera 

(MIT-Athena), and Chris Peterson (MIT-LCS). 
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NAME 

xlsfonts - server font list displayer for X 

SYNOPSIS 

xlsfonts [options ...] [-fn pattern] 

DESCRIPTION 

Xlsfonts lists the fonts that match the given pattern. The wildcard character "*" may be used to 
match any sequence of characters (including none), and "?" to match any single character. If no 
pattern is given, "*" is assumed. 

The "*" and "?" characters must be quoted to prevent them from being eiqianded by the shell. 

OPTIONS 

-display hostzdpy 

This option specifies the X server to contact. 

-I[l[l]] This option indicates that medium, long, and very long listings, respectively, should be 
generated for each font. 

-m This option indicates that long listings should also print the minimum and maximum 

bounds of each font. 

-C This option indicates that listings should use multiple columns. This is the same as -n 0. 

-1 This option indicates that listings should use a single column. This is the same as -n 1. 

-w width This option specifies the width in characters that should be used in figuring out how 
many columns to print. The default is 79. 

-n columns 

This option specifies the number of columns to use in displaying the output. By default, 
it will attempt to fit as many columns of font names into the number of character 
specified by -w width. 

-u This option indicates that the output should be left unsorted. 

-o This option indicates that xlsfonts should do an OpenFont (and QueryFont, if appropri- 

ate) rather than a ListFonts. This is useful if ListFonts or ListFontsWithlnfo fail to list a 
known font (as is the case with some scaled font systems). 

SEE ALSO 

X(l), Xserver(l), xset(l), xfd(l) 

ENVIRONMENT 

DISPLAY 

to get the default host and display to use. 

BUGS 

Doing "xlsfonts -1" can tie up your server for a very long time. This is really a bug with single- 
threaded non-preemptable servers, not with this program. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
SeeX(i) for a full statement of rights and permissions. 

AUTHOR 

Mark Lillibridge, MIT Project Athena; Jim Fulton, MIT X Consortium; Phil Kariton, SGI 
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NAME 

xmodmap - utility for modifying keymaps in X 

SYNOPSIS 

xmodmap [-options ...] [filename] 

DESCRIPTION 

The xmodmap program is used to edit and display the keyboard modifier map and keymap table 
that are used by client applications to convert event keycodes into keysyms (see Sections 7.9 and 
10.1.1 in the Xlib manual). It is usually run from the user's session startup script to configure the 
keyboard according to personal tastes. 

OPTIONS 

The following options may be used with xmodmap: 

■display display 

This option specifies the host and display to use. 

-help This option indicates that a brief description of the command line arguments should be 
printed on the standard error channel. This will be done whenever an unhandled argu- 
ment is given to xmodmap. 

-grammar 

This option indicates that a help message describing the expression grammar used in 
files and with -e expressions should be printed on the standard error. 

-verbose This option indicates that xmodmap should print logging information as it parses its 
input. 

-quiet This option turns off the verbose logging. This is the default. 

-n This option indicates that xmodmap should not change the mappings, but should display 

what it would do, like make(l) does when given this option. 

-e expression 

This option specifies an expression to be executed. Any number of expressions may be 
specified from the command line. 

-pm This option indicates that the current modifier map should be printed on the standard 
output. 

-pk This option indicates that the current keymap table should be printed on the standard 

output. 

-pp This option indicates that the current pointer map should be printed on the standard 

output. 

A lone dash means that the standard input should be used as the input file. 

The filename specifies a file containing xmodmap expressions to be executed. This file is usually 
kept in the user's home directory with a name like jcmodmaprc. 

EXPRESSION GRAMMAR 

The xmodmap program reads a list of e}q>ressions and parses them all before attempting to exe- 
cute any of them. This makes it possible to refer to keysyms that are being redefined in a natural 
way without having to worry as much about name conflicts. 

keycoda NUMBER = KEYSYMNAME ... 

The list of keysyms is assigned to the indicated keycode (which may be specified in 
decimal, hex or octal). This list determines the keysym assigned to the corresponding 
keypress event when no modified, shift, modi or shift + modi are used (the standard 
translation makes use of only the first four keysyms in the list). 

keysym KEYSYMNAME = KEYSYMNAME ... 

An alternate way of assigning keysyms to a key by identifying the key with a symbolic 
name rather than a numeric keycode. The KEYSYMNAME on the left hand side is 
translated into a keycode (using XStrin^oKeysym() and XKeysymToKQrcode()) and 
used to perform the corresponding kQ^code ej5)ression. The list of keysym names may 
be found in the header file <Xll/keysymdef.h > (without the XK_ prefix) or the keysym 
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database /usr/lib/Xll/XKeysymDB. Note that if the same keysym is bound to multiple 
keys, the results for this expression are not defined. 

clear MODIFIERNAME 

This removes all entries in the modifier map for the given modifier, where valid name 
are: Shift, Lock, Control, Modi, Mod2, Mod3, Mod4, and Mod5 (case does not matter 
in modifier names, although it does matter for all other names). For example, "clear 
Lock" will remove all any keys that were bound to the shift lock modifier. 

add MODIFIERNAME = KEYSYMNAME ... 

This adds the given keysyms to the indicated modifier map. The keysym names are 
evaluated after all input expressions are read to make it easy to write expressions to swap 
keys (see the EXAMPLES section). 

remove MODIFIERNAME = KEYSYMNAME... 

This removes the given keysyms from the indicated modifier map. Unlike add, the 
keysym names are evaluated as the line is read in. This allows you to remove keys from 
a modifier without having to worry about whether or not they have been reassigned. 

pointer = default 

This sets the pointer map back to its default settings (button 1 generates a code of 1, but- 
ton 2 generates a 2, etc.). 

pointer = NUMBER ... 

This sets to pointer map to contain the indicated button codes. The list always starts 
with the first physical button. 

Lines that begin with an exclamation point (!) are taken as comments. 

If you want to change the binding of a modifier key, you must also remove it from the appropriate 
modifier map. 

EXAMPLES 

Many pointers are designed such that the first button is pressed using the index finger of the right 
hand. People who are left-handed frequently find that it is more comfortable to reverse the but- 
ton codes that get generated so that the primary button is pressed using the index finger of the left 
hand. This could be done on a 3 button pointer as follows: 

% xmodmap -e "pointer = 321" 

Many editor applications support the notion of Meta keys (similar to Control keys except that 
Meta is held down instead of Control). However, some servers do not have a Meta keysym in the 
default keymap table, so one needs to be added by hand. The following command will attach 
Meta to the Select key. It also takes advantage of the fact that applications that need a Meta key 
simply need to get the keycode and don't require the keysym to be in the first column of the key- 
map table. This means that applications that are looking for a Multi_key (including the default 
modifier map) won't notice any change. 

% xmodmap -e "keysym Select = Select Meta_L" 

One of the more simple, yet convenient, uses of xmodmap is to set the keyboard's "rubout" key to 
generate an alternate keysym. This frequently involves exchanging Backspace with Delete to be 
more comfortable to the user. If the ttyModes resource in xterm is set as well, all terminal emula- 
tor windows will use the same key for erasing characters: 

% xmodmap -e "keysym Backspace = Delete" 

% echo "XTerm* ttyModes: erase ^?" | xrdb -merge 

Some keyboards do not automatically generate less than and greater than characters when the 
comma and period keys are shifted. This can be remedied with xmodmap by resetting the bind- 
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ings for the comma and period with the following scripts: 

make shift-, be < and shift-, be > 

keysym comma = comma less 
keysym period = period greater 

One of the more irritating differences between keyboards is the location of the Control and Shift 
Lock keys. A common use oixmodmap is to swap these two keys as follows: 

Swap Caps_Lock and Control_L 

remove Lock = Caps_Lock 
remove Control = Control_L 
keysym Control_L = Caps_Lock 
keysym Caps_Lock = Control_L 
add Lock = Caps_Lock 
add Control = Control_L 

The keycode command is useful for assigning the same keysym to multiple keycodes. Although 
unportable, it also makes it possible to write scripts that can reset the keyboard to a known state. 
The following script sets the backspace key to generate Delete (as shown above), flushes all exist- 
ing caps lock bindings, makes the CapsLock key be a control key, make F5 generate Escape, and 
makes Break/Reset be a shift lock. 

On the HP, the following keycodes have key caps as listed: 

101 Backspace 
55 Caps 

14 Ctrl 

15 Break/Reset 
86 Stop 
89 F5 

keycode 101 = Delete 
keycode 55 = Control_R 
clear Lock 

add Control = Control_R 
keycode 89 = Escape 
keycode 15 = Caps_Lock 
add Lock = Caps_Lock 

ENVIRONMENT 

DISPLAY 

to get default host and display number. 

SEE ALSO 

X(l), xev(l), Xlib documentation on key and pointer events 

BUGS 

Every time a keycode expression is evaluated, the server generates a MappingNodfy event on every 
client. This can cause some thrashing. All of the changes should be batched together and done at 
once. Clients that receive keyboard input and ignore Mappin^otify events will not notice any 
changes made to keyboard mappings. 

Xmodmap should generate "add" and "remove" expressions automatically whenever a keycode that 
is already bound to a modifier is changed. 
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There should be a way to have the remove expression accept keycodes as well as keysyms for those 
times when you really mess up your mappings. 

COPYRIGHT 

Copyright 1988, 1989, 1990 Massachusetts Institute of Technology. 

Copyright 1987 Sun Microsystems, Inc. 

See X(l) for a full statement of rights and permissions. 

AUTHOR 

Jim Fulton, MIT X Consortium, rewritten from an earlier version by David Rosenthal of Sun 
Microsystems. 
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NAME 

xpr - print an X window dump 

SYNOPSIS 

icpr [ -device dev ] [ -scale scale ] [ -height inches ] [ -width inches ] [ -left inches ] [ -top 
inches ] [ -header string ] [ -trailer string ] [ -landscape ] [ -portrait ] [ -plane number ] [ 
-gray ] [ -rv ] [ -compact ] [ -output filename ] [ -append filename ] [ -noff ] [ -split n ] [ 
-psfig ] [ -density dpi ] [ -cutoff level ] [ -noposition ] [ -gamma correction ] [ -render algo- 
rithm ] [ -slide ] [ filename ] 

DESCRIPTION 

}q)r takes as input a window dump file produced by xwd(l) and formats it for output on PostScript 
printers, the Digital LN03 or LAIOO, the IBM PP3812 page printer, the HP LaserJet (or other 
PCL printers), or the HP PaintJet. If no file argument is given, the standard input is used. By 
default, }q>r prints the largest possible representation of the window on the output page. Options 
allow the user to add headers and trailers, specify margins, adjust the scale and orientation, and 
append multiple window dumps to a single output file. Output is to standard output unless -out- 
put is specified. 

Command Options 

•device dev 

Specifies the device on which the file will be printed. Currently supported: 
lalOO Digital LAIOO 
yet HP LaserJet series and other monochrome PCL devices such as ThinkJet, 

QuietJet, RuggedWriter, HP2560 series, and HP2930 series printers 
ln03 Digital LN03 
pjet HP PaintJet (color mode) 

pjetxl HP HP PaintJet XL Color Graphics Printer (color mode) 
pp IBM PP3812 
ps PostScript printer 

The default device is the LN03, for historical reasons, -device hv (LaserWriter) is 
equivalent to -device ps and is provided only for backwards compatibility. 

-scale scale 

Affects the size of the window on the page. The PostScript, LN03, and HP printers are 
able to translate each bit in a window pixel map into a grid of a specified size. For exam- 
ple each bit might translate into a 3x3 grid. This would be specified by -scale 3. By 
default a window is printed with the largest scale that will fit onto the page for the 
specified orientation. 

-height inches 

Specifies the maximum height of the page. 

-width inches 

Specifies the maximum width of the page. 

-left inches 

Specifies the left margin in inches. Fractions are allowed. By default the window is cen- 
tered in the page. 

-top inches 

Specifies the top margin for the picture in inches. Fractions are allowed. 

-header string 

Specifies a header string to be printed above the window. 

-trailer string 

Specifies a trailer string to be printed below the window. 

-landscape 

Forces the window to printed in landscape mode. By default a window is printed such 
that its longest side follows the long side of the paper. 
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-plane number 

Specifies which bit plane to use in an image. The default is to use the entire image and 
map values into black and white based on color intensities. 

■^ay 2\3 \4 

Uses a simple 2x2, 3x3, or 4x4 gray scale conversion on a color image, rather than map- 
ping to strictly black and white. This doubles, triples, or quadruples the effective width 
and height of the image. 

•portrait 

Forces the window to be printed in portrait mode. By default a window is printed such 
that its longest side follows the long side of the paper. 

-rv Forces the window to be printed in reverse video. 

-compact 

Uses simple run-length encoding for compact representation of windows with lots of 
white pixels. 

•output filename 

Specifies an output file name. If this option is not specified, standard output is used. 

-append filename 

Specifies a filename previously produced by Apr to which the window is to be appended. 

-noif When specified in conjunction with -append, the window will appear on the same page as 
the previous window. 

-split n This option allows the user to split a window onto several pages. This might be necessary 
for very large windows that would otherwdse cause the printer to overload and print the 
page in an obscure manner. 

-psfig Suppress translation of the PostScript picture to the center of the page. 

-density dpi 

Indicates what dot-per-inch density should be used by the HP printer. 

-cutoff /o'e/ 

Changes the intensity level where colors are mapped to either black or white for mono- 
chrome output on a LaserJet printer. The level is expressed as percentage of full bright- 
ness. Fractions are allowed. 

-noposition 

This option causes header, trailer, and image positioning command generation to be 
bypassed for LaserJet, PaintJet and PaintJet XL printers. 

-gamma correction 

This changes the intensity of the colors printed by PaintJet XL printer. The correction is a 
f toating point value in the range 0.00 to 3.00. Consult the operator's manual to determine 
the correct value for the specific printer. 

-render algorithm 

This allows PaintJet XL printer to render the image with the best quality versus perfor- 
mance tradeoff. Consult the operator's manual to determine which algorithms are avail- 
able. 

-slide This option allows overhead transparencies to be printed using the PaintJet and PaintJet 
XL printers. 

SEE ALSO 

xwd(l), xwud(l), X(l) 

LIMITATIONS 

The current version oixpr can generally print out on the LN03 most X windows that are not larger 
than two-thirds of the screen. For example, it will be able to print out a large Emacs window, but 
it will usually fail when trying to print out the entire screen. The LN03 has memory limitations 
that can cause it to incorrectly print very large or complex windows. The tivo most common errors 
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encountered are "band too complex" and "page memory exceeded." In the first case, a window 
may have a particular six pixel row that contains too many changes (from black to white to black). 
This will cause the printer to drop part of the line and possibly parts of the rest of the page. The 
printer will flash the number '1' on its front panel when this problem occurs. A possible solution 
to this problem is to increase the scale of the picture, or to split the picture onto two or more 
pages. The second problem, "page memory exceeded," will occur if the picture contains too much 
black, or if the picture contains complex half-tones such as the background color of a display. 
When this problem occurs the printer will automatically split the picture into two or more pages. 
It may flash the number '5' on its from panel. There is no easy solution to this problem. It will 
probably be necessary to either cut and paste, or to rework the application to produce a less com- 
plex picture. 

There are several limitations on the LAIOO support: the picture will always be printed in portrait 
mode, there is no scaling, and the aspect ratio will be slightly off. 

Support for PostScript output currently cannot handle the -append, -noff or -split options. 

The -compact option is only supported for PostScript output. It compresses white space but not 
black space, so it is not useful for reverse-video windows. 

For color images, should map directly to PostScript image support. 

HP PRINTERS 

If no -density is specified on the command line 300 dots per inch will be assumed for Ijet and 90 
dots per inch for pjet. Allowable density values for a LaserJet printer are 300, 150, 100, and 75 
dots per inch. Consult the operator's manual to determine densities supported by other printers. 

If no -scale is specified the image will be expanded to fit the printable page area. 

The default printable page area is 8x10.5 inches. Other paper sizes can be accommodated using 
the -height and -width options. 

Note that a 1024x768 image fits the default printable area when processed at 100 dpi with scale = 1, 
the same image can also be printed using 300 dpi with scale =3 but will require considerably more 
data be transferred to the printer. 

xpr may be tailored for use with monochrome PCL printers other than the LaserJet. To print on a 
ThinkJet (HP2225A) :q)r could be invoked as: 

xpr -density 96 -width 6.661 filename 

or for black-and-white output to a PaintJet: 

xpr -density 1^0 filename 

The monochrome intensity of a pixel is computed as 0.30*R + 0.59*G + 0.11*B. If a pixel's com- 
puted intensity is less than the -cutoff level it will print as white. This maps light-on-dark display 
images to black-on-white hardcopy. The default cutoff intensity is 50% of full brightness. Exam- 
ple: specifying -cutoff 87.5 moves the white/black intensity point to 87.5% of full brightness. 

A LaserJet printer must be configured with sufficient memory to handle the image. For a full 
page at 300 dots per inch approximately 2MB of printer memory is required. 

Color images are produced on the PaintJet at 90 dots per inch. The PaintJet is limited to sixteen 
colors from its 330 color palette on each horizontal print line. :q>r will issue a warning message if 
more than sixteen colors are encountered on a line, xpr will program the PaintJet for the first six- 
teen colors encountered on each line and use the nearest matching programmed value for other 
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colors present on the line. 

Specifying the -rv, reverse video, option for the PaintJet will cause black and white to be inter- 
changed on the output image. No other colors are changed. 

Multiplane images must be recorded by xwd in ZPtxmap format. Single plane (monochrome) 
images maybe in cither XYPixmap or TLPixmap format. 

Some PCL printers do not recognize image positioning commands. Output for these printers will 
not be centered on the page and header and trailer strings may not appear where expected. 

The -^amma and -render options are supported only on the PaintJet XL printers. 

The -slide option is not supported for LaserJet printers. 

The -split option is not supported for HP printers. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
Copyright 1986, Marvin Solomon and the University of Wisconsin. 
Copyright 1988, Hewlett Packard Company. 
See X(l) for a full statement of rights and permissions. 

AUTHORS 

Michael R. Gretzinger, MIT Project Athena, Jose Capo, MIT Project Athena (PP3812 support), 
Marvin Solomon, University of Wisconsin, Bob Scheifler, MIT, Angela Bock and E. Mike Durbin, 
Rich Inc. (grayscale), Larry Rupp, HP (HP printer support). 
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NAME 

xrdb - X server resource database utility 

SYNOPSIS 

xrdb [-option ...] [filename] 

DESCRIPnON 

Xrdb is used to get or set the contents of the RESOURCE_MANAGER property on the root win- 
dow of screen 0. You would normally run this program from your X startup file to initialize the 
property with resource specifications (X defaults) from filename. You can also use xrdb to list the 
contents of the RESOURCE_MANAGER property or to modify its contents with specifications 
from cither filename or the standard input if - or no input file given. 

Client applications (which use the X Toolkit or the XLib routine XGetDefaultQXf) use the 
resource manager to obtain user preferences for color, fonts, and so on from the 
RESOURCEMANAGER property. For compatibility, if there is no RESOURCEMANAGER 
property defined (either because xrdb was not run or the property was removed), the resource 
manager will obtain user preferences from a file called JCdefaults in your home directory. How- 
ever, having this information in the server (where it is available to all clients) instead of on disk, 
solves the problem in previous versions of X that required you to maintain JCdefaults files on 
every machine that you might use. It also allows for dynamic changing of user preferences without 
editing files. 

Note that user preferences are not the only type of resource specification obtained by the resource 
manager for clients. Application class specifications (normally from an application class file in 
/usr/lib/Xll/app-defaults) and user /application class specifications are both overridden by user 
preferences. User /host specifications and process specific specifications (from the command line), 
however, both override user preferences (see the XLib Resource Manager documentation). 

The filename (or the standard input) is optionally passed through the C preprocessor with the fol- 
lowing symbols defined, based on the capabilities of the server being used: 

BITSPERRGB = num 

the number of significant bits in an RGB color specification. This is the log base 2 of the 
number of distinct shades of each primary that the hardware can generate. Note that it 
usually is not related to PLANES. 

CLASS = visualclass 

one of StaticGray, GrayScale, StaticColor, PseudoColor, TrueColor, DirectColor. This is 
the visual class of the root window of the default screen. 

COLOR defined only if CLASS is one of StaticColor, PseudoColor, TrueColor, or DirectColor. 

HEIGHT=num 

the height of the default screen in pixels. 

SERVERHOST= hostname 

the hostname portion of the display to which you are connected. 

HOST= hostname 

the same as SERVERHOST. 

CLIENTHOST= hostname 

the name of the host on which xrdb is running. 

PLANES = num 

the number of bit planes (the depth) of the root window of the default screen. 

RELEASE = num 

the vendor release number for the server. The interpretation of this number will vary 
depending on VENDOR 

REVISION = num 

the X protocol minor version supported by this server (currently 0). 

VERSION = num 

the X protocol major version supported by this server (should always be 11). 
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VENDOR= vendor 

a string specifying the vendor of the server. 

WIDTH =num 

the width of the default screen in pixels. 

X_RESOLUnON=num 

the X resolution of the default screen in pixels per meter. 

YRESOLUnON = num 

the y resolution of the default screen in pixels per meter. Lines that begin with an excla- 
mation mark (!) are ignored and maybe used as comments. 

OPTIONS 

xrdb program accepts the following options: 

-help This option (or any unsupported option) will cause a brief description of the allowable 
options and parameters to be printed. 

•display display 

This option specifies the X server to be used; see X(T)- 

-n This option indicates that changes to the property (when used with -load) or to the 

resource file (when used with -edit) should be shown on the standard output, but should 
not be performed. 

•quiet This option indicates that warning about duplicate entries should not be displayed. 

■ci^p filename 

This option specifies the pathname of the C preprocessor program to be used. Although 
xrdb was designed to use CPP, any program that acts as a filter and accepts the -D, -I, 
and -U options may be used. 

-nocpp This option indicates that xrdb should not run the input file through a preprocessor 
before loading it into the RESOURCEMANAGER property. 

-symbols 

This option indicates that the symbols that are defined for the preprocessor should be 
printed onto the standard output. It can be used in conjunction with -query, but not with 
the options that change the RESOURCEMANAGER property. 

-query This option indicates that the current contents of the RESOURCE_MANAGER pro- 
perty should be printed onto the standard output. Note that since preprocessor com- 
mands in the input resource file are part of the input file, not part of the property, they 
won't appear in the output from this option. The -edit option can be used to merge the 
contents of the property back into the input resource file without damaging preprocessor 
commands. 

-load This option indicates that the input should be loaded as the new value of the 
RESOURCE_MANAGER property, replacing whatever was there (i.e. the old contents 
are removed). This is the default action. 

-merge This option indicates that the input should be merged with, instead of replacing, the 
current contents of the RESOURCE_MANAGER property. Since xrdb can read the 
standard input, this option can be used to the change the contents of the 
RESOURCE_MANAGER property directly from a terminal or from a shell script. 
Note that this option does a lexicographic sorted merge of the two inputs, which is 
almost certainly not what you want, but remains for backward compatibility. 

-remove This option indicates that the RESOURCE_MANAGER property should be removed 
from its window. 

-retain This option indicates that the server should be instructed not to reset if xrdb is the first 
client. 

•«Avi filename 

This option indicates that the contents of the RESOURCEMANAGER property 
should be edited into the given file, replacing any values already listed there. This allows 
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you to put changes that you have made to your defaults back into your resource file, 
preserving any comments or preprocessor lines. 

-backup string 

This option specifies a suffix to be appended to the filename used with -«dit to generate 
a backup file. 

-Dname[ =value] 

This option is passed through to the preprocessor and is used to define symbols for use 
with conditionals such as #ifdef. 

-Vname This option is passed through to the preprocessor and is used to remove any definitions 
of this symbol. 

-Idirectoty 

This option is passed through to the preprocessor and is used to specify a directory to 
search for files that are referenced with ^include. 

FILES 

Generalizes ~ /JCde faults files. 

SEE ALSO 

X(l), XGetDefault(3X), Xlib Resource Manager documentation 

ENVIRONMENT 

DISPLAY 

to figure out which display to use. 

NOTES 

The default action when no action argument is specified is -load, not -query, which is inconsistent 
with the non-destructive default action of other programs. 

Resource specifications that begin with an exclamation mark (!) or (#) are ignored by xrdb and 
may be used as comments if also ignored by the preprocessor when used. Note that cpp is used as 
the default and does not ignore lines that begin with #. 

COPYRIGHT 

Copyright 1988, Digital Equipment Corporation. 

AUTHORS 

Phil Karlton, rewritten from the original by Jim Gettys 
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NAME 

xrefresh - refresh all or part of an X screen 

SYNOPSIS 

xrefresh [-option ...] 

DESCRIPTION 

Xrefresh is a simple X program that causes all or part of your screen to be repainted. This is use- 
ful when system messages have messed up your screen. Xrefresh maps a window on top of the 
desired area of the screen and then immediately unmaps it, causing refresh events to be sent to all 
applications. By default, a window with no background is used, causing all applications to repaint 
"smoothly." However, the various options can be used to indicate that a solid background (of any 
color) or the root window background should be used instead. 

ARGUMENTS 

-white Use a white background. The screen just appears to flash quickly, and then repaint. 

-black Use a black background (in effect, turning off all of the electron guns to the tube). 
This can be somewhat disorienting as everything goes black for a moment. 

-solid color 

Use a solid background of the specified color. Try green. 

-root Use the root window background. 

-none This is the default. All of the windows simply repaint. 

geometry WxH-\-X-^Y 

Specifies the portion of the screen to be repainted; seeA'(i). 

-display display 

This argument allows you to specify the server and screen to refresh; see X(i). 

X DEFAULTS 

The xrefresh program uses the routine XGetDefault{3X) to read defaults, so its resource names are 
all capitalized. 

Black, White, Solid, None, Root 

Determines what sort of window background to use. 

Geometry 

Determines the area to refresh. Not very useful. 

ENVIRONMENT 

DISPLAY - To get default host and display number. 

SEE ALSO 

X(l) 

BUGS 

It should have just one default type for the background. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See X(l) for a full statement of rights and permissions. 

AUTHORS 

Jim Gettys, Digital Equipment Corp., MIT Project Athena 
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HP-UX and OSF/1 

NAME 

xseethru - opens a transparent window into the image planes of a HP graphics display system 
while running X in the overlay planes. 

SYNOPSIS 

xseethru [-geometry geometiy] [-display displc^] 

DESCRIPTION 

Xseethru provides one method of viewing output from HP's high performance Starbase graphics 
applications while running X. 

Normally, both X and Starbase utilize the image planes of the display and can not coexist together. 
However, if X is run in the overlay planes (by modifying /usr/lib/Xll/X*screens), Starbase appli- 
cations can be run via a X terminal window and can utilize the normal Starbase output drivers that 
render to the image planes. When this is done, xseethru can be used to open a transparent win- 
dow into the "underlaying" (and hidden) image planes to view a portion (or all, if the window is 
large enough) of the Starbase output. 

Another method of viewing Starbase output while running X involves using HP's Starbase on X 
(SOX) subsystem. With this method, X is run as normal in the images planes and Starbase output 
is translated to X protocol so that it can be displayed and managed by X within a window in the 
standard X manner. 

OPTIONS 

-geometry geometry 

The transparent window is created with the specified size according to the geometry 
specification. See X(l) for details. 

-display display 

Specified the sever to use; see X{1) for details. 

ENVIRONMENT 

DISPLAY 

To get the default host and display number. 

HARDWARE DEPENDENCIES 

Only one display 0, is supported on the HP 9000 Series 300. 

Xseethru is only useful on the HP98550A, HP98720A, HP98730A, HP 98735A/36A/36B, or 
HP98705A/B/C Graphics Display Systems. 

ORIGIN 

HP 

SEE ALSO 

X(l) 
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NAME 

X - X Window System server 

SYNOPSIS 

X -.displaynumber [-option] ttyname 

DESCRIPTION 

X is the window system server. It is started by the vuelogin{lX) program which is typically run by 
init(lM). Alternatively it may be started from the xinit{l) program, which is called by xllstart. 
The displaynumber argument is used by clients in their DISPLAY environment variables to indi- 
cate which server to contact (large machines may have several displays attached). This number 
can be any number. If no number is specified is used. This number is also used in determining 
the names of various startup files. The ttyname argument is passed in by init and isn't used. 

The Hewlett-Packard server has support for the following protocols: 

TCP/IP 

The server listens on port htons(6000+N), where N is the display number. 

Local IPC Mechanism 

The file name for the socket is /usr/spool/sockets/Xll/* where "*" is the display 
number. 

When the server starts up, it takes over the display. If you are running on a workstation whose 
console is the display, you cannot log into the console while the server is running. 

OPTIONS 

The following options can be given on the command line to any X server. 

-a number 

sets pointer acceleration (i.e. the ratio of how much is reported to how much the user 
actually moved the pointer). 

-auth authorization-file 

Specifies a file which contains a collection of authorization records used to authenticate 
access. 

be disables certain kinds of error checking, for bug compatibility with previous releases 

(e.g., to work around bugs in R2 and R3 xterms and toolkits). Deprecated. 

-bs disables backing store support on all screens. 

•c turns off key-click. 

c volume 

sets key-click volume (allowable range: 0-100). 

•CO filename 

sets name of RGB color database. 

-dpi resolution 

sets the resolution of the screen, in dots per inch. To be used when the server cannot 
determine the screen size from the hardware. 

-t volume 

sets feep (bell) volume (allowable range: 0-100). 

-fc cursorFont 

sets default cursor font. 

-tnfont sets the default font. 

•fp ftfntPath 

sets the search path for fonts. This path is a comma separated list of directories which 
the sample server searches for font databases. 

-help prints a usage message. 

-I causes all remaining command line arguments to be ignored. 
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-Id kilobytes 

sets the data space limit of the server to the specified number of kilobytes. The default 
value is zero, making the data size as large as possible. A value of -1 leaves the data 
space limit unchanged. This option is not available in all operating systems. 

-Is kilobytes 

sets the stack space limit of the server to the specified number of kilobytes. The default 
value is zero, making the stack size as large as possible. A value of -1 leaves the stack 
space limit unchanged. This option is not available in all operating systems. 

-logo turns on the X Window System logo display in the screen-saver. There is currently no 
way to change this from a client. 

nologo turns off the X Window System logo display in the screen-saver. There is currently no 
way to change this from a client. 

-p minutes 

sets screen-saver pattern cycle time in minutes. 

-r turns off auto-repeat. 

r turns on auto-repeat. 

-s minutes 

sets screen-saver timeout time in minutes. 

-su disables save under support on all screens. 

-t number 

sets pointer acceleration threshold in pixels (i.e. after how many pixels pointer accelera- 
tion should take effect). 

-to seconds 

sets default connection timeout in seconds. 

ttycc ignored, for servers started the ancient way (from init). 

V sets video-on screen-saver preference. 

-V sets video-off screen-saver preference. 

-wm forces the default backing-store of all windows to be WhenMapped; a cheap trick way of 
getting backing-store to apply to all windows. 

-X extension 

loads the specified extension at init. Not supported in most implementations. 

You can also have the X server connect to xdm(l) or vuelogin(lX) using XDMCP. Although this 
is not typically useful as it doesn't allow xdm to manage the server process, it can be used to debug 
XDMCP implementations, and servers as a sample implementation of the server side of XDMCP. 
For more information on this protocol, see the XDMCP specification in 
docs/XDMCP/xdmcp.ms. The following options control the behavior of XDMCP. 

-query host-name 

Enable XDMCP and send Query packets to the specified host. 

-broadcast 

Enable XDMCP and broadcast BroadcastQuery packets to the network. The first 
responding display manager will be chosen for the session. 

-indirect host-name 

Enable XDMCP and send IndirectQuery packets to the specified host. 

-port port-num 

Use an alternate port number for XDMCP packets. Must be specified before any 
-query, -broadcast or -indirect options. Default port number is 177. 

-once Normally, the server keeps starting sessions, one after the other. This option makes the 
server exit after the first session is over. 
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-class display-doss 

XDMCP has an additional display qualifier used in resource lookup for display-specific 
options. This option sets that value, by default it is "MIT-Unspecified" (not a very useful 
value). 

•cookie xdm-auth-bits 

When testing XDM-AUTHENTICATION-1, a private key is shared between the server 
and the manager. This option sets the value of that private data (not that it's very 
private, being on the command line and all...). 

-dispIaylD display-id 

Yet another XDMCP specific value, this one allows the display manager to identify each 
display so that it can locate the shared key. 

Many servers also have device-specific command line options. See the manual pages for the indi- 
vidual servers for more details. 

RUNNING FROM INIT 

Though X will usually be run hy vueloffn from init, it is possible to run X directly from init. From 
information about running X from vueloffti, see the vuelogin man page. 

To run X directly from init, it is necessary to modify /etc/inittab and /etc/gettydefs. Detailed infor- 
mation on these files may be obtained from the inittab(4) and gettydefs(4) man pages. 

To run X from init on display 0, with a login j^cttw running on Jdev/ttypf, in init state 3, the follow- 
ing line must be added to /etc/inittab: 

X0:3:respawn:env PATH =/bin:/usr/bin/Xll:/usr/bin xinit -L ttyqf - :0 

To run X with a login hpterm, the following should be used instead: 

X0:3:respawn:envPATH=/bin:/usr/bin/Xll:/usr/bin xinit hpterm = + 1 + 1 -n login -L ttyqf ~ 
:0 

In addition, the following line must be added to /etc/gettydefs (this should be a single line): 

Xwindow# B9600 HUPCL PARENB CS7 # B9600 SANE PARENB CS7 ISTRIP IXANY 
TAB3 #X login: #Xwindow 

There should not be a getty running against the display for states in which X is run from xinit. 

SECURITY 

The sample server implements a simplistic authorization protocol, MIT-MAGIC-COOKIE-l 
which uses data private to authorized clients and the server. This is a rather trivial scheme; if the 
client passes authorization data which is the same as the server has, it is allowed access. This 
scheme is worse than the host-based access control mechanisms in environments with unsecure 
networks as it allows any host to connect, given that it has discovered the private key. But in many 
environments, this level of security is better than the host-based scheme as it allows access control 
per-user instead of per-host. 

In addition, the server provides support for a DES-based authorization scheme, XDM- 
AUTHORIZATION-1, which is more secure (given a secure key distribution mechanism), but as 
DES is not generally distributable, the implementation is missing routines to encrypt and decrypt 
the authorization data. This authorization scheme can be used in conjunction with XDMCP's 
authentication scheme, XDM-AUTHENTICATION-1 or in isolation. 

The authorization data is passed to the server in a private file named with the -auth command line 
option. Each time the server is about to accept the first connection after a reset (or when the 
server is starting), it reads this file. If this file contains any authorization records, the local host is 
not automatically allowed access to the server, and only clients which send one of the authoriza- 
tion records contained in the file in the connection setup information will be allowed access. See 
the Xau manual page for a description of the binary format of this file. Maintenance of this file, 
and distribution of its contents to remote sites for use there is left as an exercise for the reader. 

The sample server also uses a host-based access control list for deciding whether or not to accept 
connections from clients on a particular machine. This list initially consists of the host on which 
the server is running as well as any machines listed in the file /etc/Xn.hosts, where n is the display 
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number of the server. Each line of the file should contain either an Internet hostname (e.g. 
expo.lcs.mit.edu) or a DECnet hostname in double colon format (e.g. hydra::). There should be 
no leading or trailing spaces on any lines. For example: 

joesworkstation 

corporate.company.com 

star: 

bigcpu:: 

Users can add or remove hosts from this list and enable or disable access control using the xhost 
command from the same machine as the server. For example: 

% xhost +janesworkstation 

janesworkstation being added to access control list 

% xhost -star: 

public:: being removed from access control list 

% xhost + 

all hosts being allowed (access control disabled) 

% xhost - 

all hosts being restricted (access control enabled) 

% xhost 

access control enabled (only the following hosts are allowed) 

joesworkstation 

janesworkstation 

corporate.company.com 

bigcpu:: 

Unlike some window systems, X does not have any notion of window operation permissions or 
place any restrictions on what a client can do; if a program can connect to a display, it has full run 
of the screen. Sites that have better authentication and authorization systems (such as Kerberos) 
might wish to make use of the hooks in the libraries and the server to provide additional security 
models. 

SIGNALS 

A!" will catch the SIGHUP signal sent hyinit(lM) after the initial process (usually the login termi- 
nal window) started on the display terminates. This signal causes all connections to be closed 
(thereby "disowning" the terminal), all resources to be freed, and all defaults restored. 

FONTS 

Fonts are usually stored as individual files in directories. The list of directories in which the server 
looks when trying to open a font is controlled by the font pcUh. Although most sites will choose to 
have the server start up with the appropriate font path (using the -p option mentioned above), it 
can be overridden using the xset program. 

Font databases are created by running the mkfontdir program in the directory containing the com- 
piled versions of the fonts (the .snf files). Whenever fonts are added to a directory, mkfontdir 
should be rerun so that the server can find the new fonts. If mkfontdir is not run, the server will 
not be able to find any fonts in the directory. 

DIAGNOSTICS 

Too numerous to list them all. If run from init(lM), errors are logged in the file 



FILES 



/usr/adm/X*msg^, 

/etc/inittab Script for the init process 

/etc/gettydefs Speed and terminal settings used by getty 

/etc/X*. hosts Initial access control list 

/usr/lib/Xll/fonts Font directory 

/usr/lib/Xll/rgb.txt Color database 
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/usr/lib/Xll/rgb.pag Color database 

/usr/lib/Xll/rgb.dir Color database 

/usr/spool/sockets/Xll/* IPC mechanism socket 

/usr/adm/X*msgs Error log file 

/usr/lib/Xll/X*devices Input devices used by the server 

/usr/lib/Xll/X*screens Screens used by the server 

/usr/Hb/Xll/X*pointerkeys Keyboard pointer device file 

NOTES 

The option syntax is inconsistent with itself and xsetQ). 

The acceleration option should take a numerator and a denominator like the protocol. 

UX dies before its clients, new clients won't be able to connect until all existing connections have 
their TCP TIMEWAIT timers expire. 

The color database is missing a large number of colors. However, there doesn't seem to be a 
better one available that can generate RGB values. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See X(l) for a full statement of rights and permissions. 

ORIGIN 

MIT Distribution 

SEE ALSO 

vuelogin(lX) bdftosnf bitmap(l), getty(lM), gettydefs(4), gwindstop(l), hpterm(l), init(lM), init- 
tab(4), rgb(l), uwm(l), xllstart(l), xclock(l), xfc(l), xfd(l), xhost(l), xinit(l), xinitcolormap(l), 
xload(l), xmodmap(l), xrefresh(l), xseethru(l), xset(l), xsetroot(l), xterm(l), xwcreate(l), 
xwd(l), xwdestroy(l), xwininfo(l), xwud(l), Programming With Xlib, Programming With the Xt 
Intrinsics 
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NAME 

xset - user preference utility for X 

SYNOPSIS 

xset [-display displc^] [-b] \b on/off] [b [volume \pitch [duration]]] [[-]bc] [-c] [c on/off] [c 
[volume]] [[-+]fp[-+=] p(tth[pat/i[,...]]] [ip default] [fp rehash] [[-]led [integer]] [led on/off] 
[m[ouse] [accel_mult[/accel_div] [threshold]]] [m[ouse] default] [p pixel color] [[-]r] [r on/off] [s 
[lengfh [period]]] [s blank/noblank] [s expose/noexpose] [s on/o£f] [s default] [q] 

DESCRIPTION 

This program is used to set various user preference options of the display. 

OPTIONS 

-display display 

This option specifies the server to use; see X(l). 

b The b option controls bell volume, pitch and duration. This option accepts up to three 

numerical parameters, a preceding dash(-), or a 'on/ofT flag. If no parameters are given, 
or the 'on' flag is used, the system defaults will be used. If the dash or 'off are given, the 
bell will be turned off. If only one numerical parameter is given, the bell volume will be 
set to that value, as a percentage of its maximum. Likewise, the second numerical 
parameter specifies the bell pitch, in hertz, and the third numerical parameter specifies 
the duration in milliseconds. Note that not all hardware can vary the bell characteristics. 
The X server will set the characteristics of the bell as closely as it can to the user's 
specifications. 

be The be option controls bug compatibility mode in the server, if possible; a preceding 

dash(-) disables the mode, otherwise the mode is enabled. Various pre-R4 clients pass 
illegal values in some protocol requests, and pre-R4 servers did not correctly generate 
errors in these cases. Such clients, when run against an R4 server, will terminate abnor- 
mally or otherwise fail to operate correctly. Bug compatibility mode explicitly reintro- 
duces certain bugs into the X server, so that many such clients can still be run. This 
mode should be used with care; new application development should be done with this 
mode disabled. The server must support the MIT-SUNDRY-NONSTANDARD proto- 
col extension in order for this option to work. 

c The c option controls key click. This option can take an optional value, a preceding 

dash(-), or an 'on/ofF flag. If no parameter or the 'on' flag is given, the system defaults 
will be used. If the dash or 'off* flag is used, keyclick will be disabled. If a value from to 
100 is given, it is used to indicate volume, as a percentage of the maximum. The X server 
will set the volume to the nearest value that the hardware can support. 

tp= path,... 

The ^)= sets the font path to the directories given in the path argument. The directories 
are interpreted by the server, not by the client, and are server-dependent. Directories 
that do not contain font databases created by mkfontdir will be ignored by the server. 

fjp default 

The default argument causes the font path to be reset to the server's default. 

^ rehash 

The rehash argument causes the server to reread the font databases in the current font 
path. This is generally only used when adding new fonts to a font directory (after run- 
ning mkfontdir to recreate the font database). 

-fp or fp- 

The -fp and fp- options remove elements from the current font path. They must be fol- 
lowed by a comma-separated list of directories. 

+fp or fp+ 

This +fp and tp+ options prepend and append elements to the current font path, 
respectively. They must be followed by a comma-separated list of directories. 

led The led option controls the keyboard LEDs. This controls the turning on or off of one 

or all of the LEDs. It accepts an optional integer, a preceding dash(-) or an 'on/ofP flag. 
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If no parameter or the 'on' flag is given, all LEDs are turned on. If a preceding dash or 
the flag 'ofP is given, all LEDs are turned oflf. If a value between 1 and 32 is given, that 
LED will be turned on or off depending on the existence of a preceding dash. A com- 
mon LED which can be controlled is the "Caps Lock" LED. "xset led 3" would turn led 
#3 on. "xset -led 3" would turn it off. The particular LED values may refer to different 
LEDs on different hardware. 

m The m option controls the mouse parameters. The parameters for the mouse are 

'acceleration' and 'threshold'. The acceleration can be specified as an integer, or as a 
simple fraction. The mouse, or whatever pointer the machine is connected to, will go 
'acceleration' times as fast when it travels more than 'threshold' pixels in a short time. 
This way, the mouse can be used for precise alignment when it is moved slowly, yet it can 
be set to travel across the screen in a flick of the wrist when desired. One or both 
parameters for the m option can be omitted, but if only one is given, it will be interpreted 
as the acceleration. If no parameters or the flag 'default' is used, the system defaults will 
beset. 

p The p option controls pixel color values. The parameters are the color map entry 

number in decimal, and a color specification. The root background colors may be 
changed on some servers by altering the entries for BlackPixel and WhitePixel. 
Although these are often and 1, they need not be. Also, a server may choose to allo- 
cate those colors privately, in which case an error will be generated. The map entry must 
not be a read-only color, or an error will result. 

r The r option controls the autorepeat. If a preceding dash or the 'off* flag is used, 

autorepeat will be disabled. If no parameters or the 'on' flag is used, autorepeat will be 
enabled. 

s The s option lets you set the screen saver parameters. This option accepts up to two 

numerical parameters, a 'blank/noblank' flag, an 'expose/noexpose' flag, an 'on/off' flag, 
or the 'default' flag. If no parameters or the 'default' flag is used, the system will be set 
to its default screen saver characteristics. The 'on/off flags simply turn the screen saver 
functions on or off. The 'blank' flag sets the preference to blank the video (if the 
hardware can do so) rather than display a background pattern, while 'noblank' sets the 
preference to display a pattern rather than blank the video. The 'expose' flag sets the 
preference to allow window exposures (the server can freely discard window contents), 
while 'noexpose' sets the preference to disable screen saver unless the server can regen- 
erate the screens without causing exposure events. The length and period parameters 
for the screen saver function determines how long the server must be inactive for screen 
saving to activate, and the period to change the background pattern to avoid bum in. 
The arguments are specified in seconds. If only one numerical parameter is given, it will 
be used for the length. 

q The q option gives you information on the current settings. 

These settings will be reset to default values when you log out. 

Note that not all X implementations are guaranteed to honor all of these options. 

SEE ALSO 

X(l), Xserver(l), xmodmap(l), xrdb(l), xsetroot(l) 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See X(l) for a full statement of rights and permissions. 

AUTHOR 

Bob Scheifler, MIT Laboratory for Computer Science 
David Krikorian, MIT Project Athena (XI 1 version) 
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NAME 

xsetroot - root window parameter setting utility for X 

SYNOPSIS 

xsetroot [-help] [-def] [-display display] [-cursor cursorfile maskfile] [-cursor_name cursomame] 
[-bitmap filename] [-mod x y] [-gray] [-grey] [-fg color] [-bg color] [-rv] [-solid color] [-name 
string] 

DESCRIPTION 

The setroot program allows you to tailor the appearance of the background ("root") window on a 
workstation display running X. Normally, you experiment with xsetroot until you find a personal- 
ized look that you like, then put the xsetroot command that produces it into your X startup file. If 
no options are specified, or if -def is specified, the window is reset to its default state. The -def 
option can be specified along with other options and only the non-specified characteristics will be 
reset to the default state. 

Only one of the background color/ tiling changing options (-solid, -gray, -grey, -bitmap, and -mod) 
may be specified at a time. 

OPTIONS 

The various options are as follows: 

-help Print a usage message and exit. 

-def Reset unspecified attributes to the default values. (Restores the background to the fami- 
liar gray mesh and the cursor to the hollow x shape.) 

-cursor cursorfile maskfile 

This lets you change the pointer cursor to whatever you want when the pointer cursor is 
outside of any window. Cursor and mask files are bitmaps (little pictures), and can be 
made with the bitmapil) program. You probably want the mask file to be all black until 
you get used to the way masks work. 

-cursor_name cursomame 

This lets you change the pointer cursor to one of the standard cursors from the cursor 
font. Refer to appendix B of the X protocol for the names (except that the XC_ prefix is 
elided for this option). 

-bitmap filename 

Use the bitmap specified in the file to set the window pattern. You can make your own 
bitmap files (little pictures) using the bitmap(l) program. The entire background will be 
made up of repeated "tiles" of the bitmap. 

•moAxy 

This is used if you want a plaid-like grid pattern on your screen, x and y are integers 
ranging from 1 to 16. Try the different combinations. Zero and negative numbers are 
taken as 1. 

-gray Make the entire background gray. (Easier on the eyes.) 

■grey Make the entire background grey. 

•t% color 

Use "color" as the foreground color. Foreground and background colors are meaningful 
only in combination with -cursor, -bitmap, or -mod. 

-bg color 

Use "color" as the background color. 

-rv This exchanges the foreground and background colors. Normally the foreground color is 
black and the background color is white. 

-solid color 

This sets the background of the root window to the specified color. This option is only 
useful on color servers. 

-name string 

Set the name of the root window to "string". There is no default value. Usually a name is 
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assigned to a window so that the window manager can use a text representation when the 
window is iconified. This option is unused since you can't iconify the background. 

-display display 

Specifies the server to connect to; see X(l). 

SEE ALSO 

X(l), xset(l), xrdb(l) 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
S&&X{1) for a full statement of rights and permissions. 

AUTHOR 

Mark Lillibridge, MIT Project Athena 
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NAME 

xtenn - tenninal emulator for X 

SYNOPSIS 

xterm {-tooUdtoption ...] [-option ...] 

DESCRIPTION 

The Xterm program is a terminal emulator for the X Window System. It provides DEC VT102 and 
Tektronix 4014 compatible terminals for programs that can't use the window system directly. If the 
underlying operating system supports terminal resizing capabilities (for example, the SIGWINCH 
signal in systems derived from 4.3bsd), xtemt will use the facilities to notify programs running in 
the window whenever it is resized. 

The VT102 and Tektronix 4014 terminals each have their own window so that you can edit text in 
one and look at graphics in the other at the same time. To maintain the correct aspect ratio 
(height/width), Tektronix graphics will be restricted to the largest box with a 4014's aspect ratio 
that will fit in the window. This box is located in the upper left area of the window. 

Although both windows may be displayed at the same time, one of them is considered the "active" 
window for receiving keyboard input and terminal output. This is the window that contains the 
text cursor and whose border highlights whenever the pointer is in either window. The active win- 
dow can be chosen through escape sequences, the "Modes" menu in the VT102 window, and the 
"Tektronix" menu in the 4014 window. 

OPTIONS 

The xterm terminal emulator accepts all of the standard X Toolkit command line options as well as 
the following (if the option begins with a '+' instead of a '-', the option is restored to its default 
value): 

-help This causes xtemt to print out a verbose message describing its options. 

-132 Normally, the VT102 DECCOLM escape sequence that switches between 80 and 132 
column mode is ignored. This option causes the DECCOLM escape sequence to be 
recognized, and the xterm window will resize appropriately. 

-ah This option indicates that xterm should always highlight the text cursor and borders. By 

default, xterm will display a hollow text cursor whenever the focus is lost or the pointer 
leaves the window. 

+ah This option indicates that xterm should do text cursor highlighting. 

-b number 

This option specifies the size of the inner border (the distance between the outer edge of 
the characters and the window border) in pixels. The default is 2. 

-cc characterclassrangen>alue[^.] 

This sets classes indicated by the given ranges for using in selecting by words. See the 
section specifying character classes. 

-en This option indicates that newlines should not be cut in line-mode selections. 

+cn This option indicates that newlines should be cut in line-mode selections. 

■«r color This option specifies the color to use for text cursor. The default is to use the same fore- 
ground color that is used for text. 

-cu This option indicates that xterm should work around a bug in the curses (3x) cursor 

motion package that causes the more(V) program to display lines that are exactly the 
width of the window and are followed by a line beginning with a tab to be displayed 
incorrectly (the leading tabs are not displayed). 

+ CU This option indicates that that xterm should not work around the curses (3x) bug men- 
tioned above. 

■eprogram [arffiments ...] 

This option specifies the program (and its command line arguments) to be run in the 
xtemt window. It also sets the window title and icon name to be the basename of the 
program being executed if neither -T nor -« are given on the command line. This must 
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be the last option on the command line. 

-fb font This option specifies a font to be used when displaying bold text. This font must be the 
same height and width as the normal font. If only one of the normal or bold fonts is 
specified, it will be used as the normal font and the bold font will be produced by over- 
striking this font. The default is to do overstriking of the normal font. 

•j This option indicates that xterm should do jump scrolling. Normally, text is scrolled one 

line at a time; this option allows xterm to move multiple lines at a time so that it doesn't 
fall as far behind. Its use is strongly recommended since it make xterm much faster when 
scanning through large amounts of text. The VTIOO escape sequences for enabling and 
disabling smooth scroll as well as the "Modes" menu can be used to turn this feature on 
or off. 

+ j This option indicates that xterm should not do jump scrolling. 

-1 This option indicates that xterm should send all terminal output to a log file as well as to 

the screen. This option can be enabled or disabled using the "xterm Xll" menu. 

+1 This option indicates that xterm should not do logging. 

-\f filename 

This option specifies the name of the file to which the output log described above is writ- 
ten. If file begins with a pipe symbol (|), the rest of the string is assumed to be a com- 
mand to be used as the endpoint of a pipe. The default filename is "XtermLogJKXXXy 
(where XXXXX is the process id of xterm) and is created in the directory from which 
xterm was started (or the user's home directory in the case of a login window). 

-Is This option indicates that the shell that is started in the xterm window be a login shell 

(i.e. the first character of argv[0] will be a dash, indicating to the shell that it should read 
the user's .login or .profile). 

+Is This option indicates that the shell that is started should not be a login shell (i.e. it will 
be a normal "subshell"). 

-mb This option indicates that xterm should ring a margin bell when the user types near the 
right end of a line. This option can be turned on and off from the "Modes" menu. 

+mb This option indicates that margin bell should not be rung. 

-mc milliseconds 

This option specifies the maximum time between multi-click selections. 

-ms color 

This option specifies the color to be used for the pointer cursor. The default is to use 
the foreground color. 

-nb number 

This option specifies the number of characters from the right end of a line at which the 
margin bell, if enabled, will ring. The default is 10. 

-rw This option indicates that reverse-wraparound should be allowed. This allows the cursor 

to back up from the leftmost column of one line to the rightmost column of the previous 
line. This is very useful for editing long shell command lines and is encouraged. This 
option can be turned on and off from the "Modes" menu. 

+rw This option indicates that reverse-wraparound should not be allowed. 

-aw This option indicates that auto-wraparound should be allowed. This allows the cursor to 

automatically wrap to the beginning of the next line when when it is at the rightmost 
position of a line and text is output. 

+aw This option indicates that auto-wraparound should not be allowed. 

-s This option indicates HaaX xterm may scroll asynchronously, meaning that the screen does 

not have to be kept completely up to date while scrolling. This allows xterm to run faster 
when network latencies are very high and is typically useful when running across a very 
large internet or many gateways. 
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+ s This option indicates that xterm should scroll synchronously. 

-sb This option indicates that some number of lines that are scrolled off the top of the win- 

dow should be saved and that a scrollbar should be displayed so that those lines can be 
viewed. This option may be turned on and off from the "Modes" menu. 

+ sb This option indicates that a scrollbar should not be displayed. 

-sf This option indicates that Sun Function Key escape codes should be generated for func- 

tion keys. 

+ sf This option indicates that the standard escape codes should be generated for function 
keys. 

-si This option indicates that output to a window should not automatically reposition the 

screen to the bottom of the scrolling region. This option can be turned on and off from 
the "Modes" menu. 

+ si This option indicates that output to a window should cause it to scroll to the bottom. 

-sk This option indicates that pressing a key while using the scrollbar to review previous 

lines of text should cause the window to be repositioned automatically in the normal 
position at the bottom of the scroll region. 

+ sk This option indicates that pressing a key while using the scrollbar should not cause the 
window to be repositioned. 

-si number 

This option specifies the number of lines to save that have been scrolled off the top of 
the screen. The default is 64. 

-t This option indicates that xterm should start in Tektronix mode, rather than in VT102 

mode. Switching between the two windows is done using the "Modes" menus. 

+ 1 This option indicates that xterm should start in VT102 mode. 

-tm string 

This option specifies a series of terminal setting keywords followed by the characters that 
should be bound to those functions, similar to the stt^ program. Allowable keywords 
include: intr, quit, erase, kill, eof, eol, swtch, start, stop, brk, susp, dsusp, rpmt, flush, 
weras, and Inext. Control characters may be specified as '"char (e.g. ''c or '^u) and ''? 
may be used to indicate delete. 

Anname 

This option specifies the name of the terminal type to be set in the TERM environment 
variable. This terminal type must exist in the termcap(S) database and should have li# 
and co# entries. 

-ut This option indicates that xterm shouldn't write a record into the the system log file 

/etc/utmp. 

+ut This option indicates that xterm should write a record into the system log file /etc/utmp. 

-vb This option indicates that a visual bell is preferred over an audible one. Instead of ring- 

ing the terminal bell whenever a Control-G is received, the window will be flashed. 

+vb This option indicates that a visual bell should not be used. 

^wf This option indicates that xterm should wait for the window to be mapped the first time 

before starting the subprocess so that the initial terminal size settings and environment 
variables are correct. It is the application's responsibility to catch subsequent terminal 
size changes. 

+wf This option indicates that xterm show not wait before starting the subprocess. 

-C This option indicates that this window should receive console output. This is not sup- 

ported on all systems. 

-Seen This option specifies the last two letters of the name of a pseudoterminal to use in slave 
mode, plus the number of the inherited file descriptor. The option is parsed "%c%c%d". 
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This allows xterm to be used as an input and output channel for an existing program and 
is sometimes used in specialized applications. 

The following command line arguments are provided for compatibility with older versions. They 
may not be supported in the next release as the X Toolkit provides standard options that accom- 
plish the same task. 

%geom This option specifies the preferred size and position of the Tektronix window. It is 
shorthand for specifying the **tekGeometfy'' resource. 

#geom This option specifies the preferred position of the icon window. It is shorthand for 
specifying the "'iconGeometiy' resource. 

-T string This option specifies the title forxterm^s windows. It is equivalent to -title. 

-n string This option specifies the icon name for;aemj's windows. It is shorthand for specifying 
the ''*iconName'' resource. Note that this is not the same as the toolkit option -name 
(see below). The default icon name is the application name. 

-r This option indicates that reverse video should be simulated by swapping the foreground 

and background colors. It is equivalent to -reversevideo or -rv. 

-w number 

This option specifies the width in pixels of the border surrounding the window. It is 
equivalent to -borderwidth or -bw. 

The following standard X Toolkit command line arguments are commonly used with xterm: 

-bg color 

This option specifies the color to use for the background of the window. The default is 

'Vhite." 

-bd color 

This option specifies the color to use for the border of the window. The default is 
"black." 

-bw number 

This option specifies the width in pixels of the border surrounding the window. 

-^ color This option specifies the color to use for displaying text. The default is "black". 

-fn font This option specifies the font to be used for displaying normal text. The default is fixed. 

-name name 

This option specifies the application name under which resources are to be obtained, 
rather than the default executable file name. Name should not contain "." or "*" charac- 
ters. 

4itle string 

This option specifies the window title string, which may be displayed by window 
managers if the user so chooses. The default title is the command line specified after the 
-e option, if any, otherwise the application name. 

-rv This option indicates that reverse video should be simulated by swapping the foreground 

and background colors. 

geometry geometry 

This option specifies the preferred size and position of the VT102 window; see X(l). 

-display display 

This option specifies the X server to contact; see X(l). 

-xrm resourcestring 

This option specifies a resource string to be used. This is especially useful for setting 
resources that do not have separate command line options. 

-iconic This option indicates that xterm should ask the window manager to start it as an icon 
rather than as the normal window. 
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RESOURCES 

The program understands all of the core X Toolkit resource names and classes as well as: 

iconGeometry (class IconGeometry) 

Specifies the preferred size and petition of the application when iconified. It is not 
necessarily obeyed by all window managers. 

termName (class TermName) 

Specifies the terminal type name to be set in the TERM environment variable. 

title (class Title) 

Specifies a string that may be used by the window manager when displa)nng this applica- 
tion. 

ttyModes (class TtyModes) 

Specifies a string containing terminal setting keywords and the characters to which they 
may be bound. Allowable keywords include: intr, quit, erase, kill, eof, eol, swtch, start, 
stop, brk, susp, dsusp, rpmt, flush, weras, and Inext. Control characters may be specified 
as "char (e.g. ''c or "u) and "? may be used to indicate delete. This is very useful for 
overriding the default terminal settings without having to do an stty every time an xtenn is 
started. 

utmplnhibit (class Utmplnhibit) 

Specifies whether or not xterm should try to record the user's terminal in letclutmp. 

sunl^nctionKeys (class SunRinctionKeys) 

Specifies whether or not Sun Function Key escape codes should be generated for func- 
tion keys instead of standard escape sequences. 

The following resources are specified as part of the vtlOO widget (class VTIOO): 

allowSendEvents (class AUowSendEvents) 

Specifies whether or not synthetic key and button events (generated using the X protocol 
SendEvent request) should be interpreted or discarded. The default is "false" meaning 
they are discarded. Note that allowing such events creates a very large security hole. 

alwaysHighlight (class AhvaysHighlight) 

Specifies whether or not xterm should always display a highlighted text cursor. By 
default, a hollow text cursor is displayed whenever the pointer moves out of the window 
or the window loses the input focus. 

boIdFont (class Font) 

Specifies the name of the bold font to use instead of overstriking. 

cl32 (class C132) 

Specifies whether or not the VT102 DECCOLM escape sequence should be honored. 
The default is "false." 

charClass (class CharClass) 

Specifies comma-separated lists of character class bindings of the form [low-yti^:v(Uue. 
TTiese are used in determining which sets of characters should be treated the same when 
doing cut and paste. See the section on specifying character classes. 

curses (class Curses) 

Specifies whether or not the last column bug in curses (3x) should be worked around. 
The default is "false." 

background (class Background) 

Specifies the color to use for the background of the window. The default is "white." 

foreground (class Foreground) 

Specifies the color to use for displaying text in the window. Setting the class name 
instead of the instance name is an easy way to have everything that would normally 
appear in the "text" color change color. The default is "black." 
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cursorCoIor (class Foreground) 

Specifies the color to use for the text cursor. The default is "black." 

eightBitlnput (class EightBitlnput) 

Specifies how a character input from the keyboard via the action, insert-eight-bit() is 
modified (iiisert-eight-bit() is normally bound to Meta<KejPress>). If "true", the char- 
acter always has its high bit set on. If "false", ESC is prepended to the character without 
modifying it. The default is "true." 

eightBitOutput (class EightBitOutput) 

Specifies whether or not eight-bit characters sent from the host should be accepted as is 
or stripped when printed. The default is "true." 

font (class Font) 

Specifies the name of the normal font. The default is "fixed." 

fontl (class Fontl) 

Specifies the name of the first alternate font. 

font2 (class Font2) 

Specifies the name of the second alternate font 

fonts (class Font3) 

Specifies the name of the third alternate font. 

font4 (class Font4) 

Specifies the name of the fourth alternate font. 

geometry (class Geometry) 

Specifies the preferred size and position of the VT102 window. 

intemalBorder (class BorderWidth) 

Specifies the number of pixels between the characters and the window border. The 
default is 2. 

jumpScroU (class JumpScrolI) 

Specifies whether or not jump scroll should be used. The default is "true". 

logFile (class Logfile) 

Specifies the name of the file to which a terminal session is logged. The default is 
"XtermLogJOOOOC' (where XXXXX is the process id ofxtenn). 

logging (class Logging) 

Specifies whether or not a terminal session should be logged. The default is "false." 

loglnhibit (class Loglnhibit) 

Specifies whether or not terminal session logging should be inhibited. The default is 
"false." 

loginShell (class LoginShell) 

Specifies whether or not the shell to be run in the window should be started as a login 
shell. The default is "false." 

marginBell (class MarginBell) 

Specifies whether or not the bell should be run when the user types near the right mar- 
gin. The default is "false." 

multiScroU (class MuItiScroIl) 

Specifies whether or not asynchronous scrolling is allowed. The default is "false." 

multiCIickTime (class MuItiCHckTime) 

Specifies the maximum time in milliseconds between multi-clock select events. The 
default is 250 milliseconds. 

muItiScroll (class MultiScroU) 

Specifies whether or not scrolling should be done asynchronously. The default is "false." 

nMai^inBell (class Column) 

Specifies the number of characters from the right margin at which the margin bell should 

Hewlett-Packard Company - 6 - X Window System Release 4 



XTERM(l) XTERM(l) 



be run, when enabled. 

pointerColor (class Foreground) 

Specifies the foreground color of the pointer. The default is "XtDefaultForeground." 

pointerColorBackground (class Background) 

Specifies the background color of the pointer. The default is "XtDefaultBackground." 

pointerShape (class Cursor) 

Specifies the name of the shape of the pointer. The default is "xterm." 

reverseVideo (class ReverseVideo) 

Specifies whether or not reverse video should be simulated. The default is "false." 

reverseWrap (class ReverseWrap) 

Specifies whether or not reverse-wraparound should be enabled. The default is "false." 

autoWrap (class AutoWrap) 

Specifies whether or not auto-wraparound should be enabled. The default is "true." 

saveLines (class SaveLines) 

Specifies the number of lines to save beyond the top of the screen when a scrollbar is 
turned on. The default is 64. 

scroUBar (class ScroUBar) 

Specifies whether or not the scrollbar should be displayed. The default is "false." 

scrollTtyOutput (class ScroUCond) 

Specifies whether or not output to the terminal should automatically cause the scrollbar 
to go to the bottom of the scrolling region. The default is "true." 

scrolIKey (class ScroUCond) 

Specifies whether or not pressing a key should automatically cause the scrollbar to go to 
the bottom of the scrolling region. The default is "false." 

scroULines (class ScroULines) 

Specifies the number of lines that the scroll-back and scroll-forw actions should use as a 
default. The default value is 1. 

signallnhibit (class Signallnhibit) 

Specifies whether or not the entries in the "xterm Xll" menu for sending signals to 
xterm should be disallowed. The default is "false." 

tekGeometry (class Geometry) 

Specifies the preferred size and position of the Tektronix window. 

teklnhibit (class Teklnhibit) 

Specifies whether or not Tektronix mode should be disallowed. The default is "false." 

tekSmall (class TekSmall) 

Specifies whether or not the Tektronix mode window should start in its smallest size if no 
explicit geometry is given. This is useful when running xterm on displays with small 
screens. The default is "false." 

tekStartup (class TekStartup) 

Specifies whether or not xterm should start up in Tektronix mode. The default is "false." 

titelnhibit (class Titelnhibit) 

Specifies whether or not xterm should remove remove ti or te termcap entries (used to 
switch between alternate screens on startup of many screen-oriented programs) from the 
TERMCAP string. 

translations (class Translations) 

Specifies the key and button bindings for menus, selections, "programmed strings", etc. 
See ACTIONS below. 

visualBell (class VisualBell) 

Specifies whether or not a visible bell (i.e. flashing) should be used instead of an audible 
bell when Control-G is received. The default is "false." 
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waitForMap (class WaitForMap) 

Specifies whether or not xtetm should wait for the initial window map before starting the 
subprocess. The default is "false." 

The following resources are specified as part of the tek4014 widget (class Tek4014): 

width (class Width) 

Specifies the width of the Tektronix window in pixels. 

height (class Height) 

Specifies the height of the Tektronix window in pixels. 

fontLarge (class Font) 

Specifies the large font to use in the Tektronix window. 

font2 (class Font) 

Specifies font number 2 to use in the Tektronix window. 

font3 (class Font) 

Specifies font number 2 font to use in the Tektronix window. 

fontSmall (class Font) 

Specifies the small font to use in the Tektronix window. 

The resources that may be specified for the various menus are described in the documentation for 
the Athena SimpIeMenu widget. The name and classes of the entries in each of the menus are 
listed below. 

The mainMenu has the following entries: 

securekbd (class SmeBSB) 

This entry invokes the secure() action. 

allowsends (class SmeBSB) 

This entry invokes the aHow-send-events(toggle) action. 

logging (class SmeBSB) 

This entry invokes the set-logging(toggle) action. 

redraw (class SmeBSB) 

This entry invokes the redraw() action. 

linel (class SmeLine) 

This is a separator. 

suspend (class SmeBSB) 

This entry invokes the send-signal(suspend) action on systems that support job control. 

continue (class SmeBSB) 

This entry invokes the send-signal(cont) action on systems that support job control. 

interrupt (class SmeBSB) 

This entry invokes the send-signal(int) action. 

hangup (class SmeBSB) 

This entry invokes the send-signal(hup) action. 

terminate (class SmeBSB) 

This entry invokes the send-signal(tenn) action. 

kill (class SmeBSB) 

This entry invokes the send-signal(kill) action. 

Iine2 (class SmeLine) 

This is a separator. 

quit (class SmeBSB) 

This entry invokes the quit() action. 
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The vtMenu has the following entries: 

scrollbar (class SmeBSB) 

This entry invokes the set-scrollbar(toggle) action. 

jumpscroU (class SmeBSB) 

This entry invokes the set-jumpscroll(toggle) action. 

reversevideo (class SmeBSB) 

This entry invokes the set-reverse-video(toggle) action. 

autowrap (class SmeBSB) 

This entry invokes the set-autowrap(toggle) action. 

reversewrap (class SmeBSB) 

liiis entry invokes the set-reversewrap(toggle) action. 

autolinefeed (class SmeBSB) 

This entry invokes the set-autolinefeed(toggle) action. 

appcursor (class SmeBSB) 

This entry invokes the set-appcursor(toggle) action. 

appkeypad (class SmeBSB) 

This entry invokes the set-appk^pad (toggle) action. 

scrollkey (class SmeBSB) 

This entry invokes the set-scroll-on-key(toggle) action. 

scrolUtyoutput (class SmeBSB) 

This entry invokes the set-scroll-on-tty-output(toggle) action. 

allowl32 (class SmeBSB) 

This entry invokes the set-allowl32(toggle) action. 

cursesemul (class SmeBSB) 

This entry invokes the set-cursesemul(toggle) action. 

visualbell (class SmeBSB) 

This entry invokes the set-visualbell(toggle) action. 

marginbell (class SmeBSB) 

This entry invokes the set-mai^inbell(toggle) action. 

altscreen (class SmeBSB) 

This entry is currently disabled. 

linel (class SmeLine) 

This is a separator. 

softreset (class SmeBSB) 

This entry invokes the soft-reset () action. 

hardreset (class SmeBSB) 

This entry invokes the hard-reset() action. 

Iine2 (class SmeLine) 

This is a separator. 

tekshow (class SmeBSB) 

This entry invokes the set-visibility(tek,toggle) action. 

tekmode (class SmeBSB) 

This entry invokes the set-terminal-type(tek) action. 

vthide (class SmeBSB) 

This entry invokes the set-visibility(vt,off) action. 



The fontMenu has the following entries: 
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fontdefault (class SmeBSB) 

This entry invokes the set-vt-font(d) action. 

fontl (class SmeBSB) 

This entry invokes the set-vt-font(l) action. 

font2 (class SmeBSB) 

This entry invokes the set-vt-font(2) action. 

font3 (class SmeBSB) 

This entry invokes the set-vt-font(3) action. 

font4 (class SmeBSB) 

This entry invokes the set-vt-font(4) action. 

fontescape (class SmeBSB) 

This entry invokes the set-vt-font(e) action. 

fontsel (class SmeBSB) 

This entry invokes the set-vt<font(s) action. 

The tekMenu has the following entries: 

tektextlai^e (class SmeBSB) 

This entry invokes the set-tek4ext(l) action. 

tektext2 (class SmeBSB) 

This entry invokes the set-tek-text(2) action. 

tektexta (class SmeBSB) 

This entry invokes the set-tek-text(3) action. 

tektextsmall (class SmeBSB) 

This entry invokes the set4ek-text(s) action. 

linel (class SmeLine) 

This is a separator. 

tekpage (class SmeBSB) 

This entry invokes the tek-page() action. 

tekreset (class SmeBSB) 

This entry invokes the tek-reset() action. 

tekcopy (class SmeBSB) 

This entry invokes the tek-copy() action. 

Iine2 (class SmeLine) 

This is a separator. 

vtshow (class SmeBSB) 

This entry invokes the set-visibility(vt,toggle) action. 

vtmode (class SmeBSB) 

This entry invokes the set-terminal-type(vt) action. 

tekhide (class SmeBSB) 

This entry invokes the set-visibiIity(tek,toggIe) action. 

The following resources are useful when specified for the Athena Scrollbar widget: 

thickness (class Thickness) 

Specifies the width in pixels of the scrollbar. 

background (class Background) 

Specifies the color to use for the background of the scrollbar. 

foreground (class Foreground) 

Specifies the color to use for the foreground of the scrollbar. The "thumb" of the 
scrollbar is a simple checkerboard pattern alternating pixels for foreground and 
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background color. 

EMULATIONS 

The VT102 emulation is fairly complete, but does not support the blinking character attribute nor 
the double-wide and double-size character sets. Termcap(5) entries that work with xterm include 
"xterm", "vtl02", "vtlOO" and "ansi", and xtenn automatically searches the termcap file in this 
order for these entries and then sets the "TERM" and the "TERMCAP" environment variables. 

Many of the special xterm features (like logging) may be modified under program control through 
a set of escape sequences different from the standard VT102 escape sequences. (See the "Xterm 
Control Sequences" document.) 

The Tektronix 4014 emulation is also fairly good. Four different font sizes and five different lines 
types are supported. The Tektronix text and graphics commands are recorded internally by xterm 
and may be written to a file by sending the COPY escape sequence (or through the Tektronix 
menu; see below). The name of the file will be "COPYyy-MM-ddJthwtm'^s", where >y, MM, dd, 
hh, mm and ss are the year, month, day, hour, minute and second when the COPY was performed 
(the file is created in the directory xtemi is started in, or the home directory for a login xterm). 

POINTER USAGE 

Once the VT102 window is created, xterm allows you to select text and copy it within the same or 
other windows. 

The selection functions are invoked when the pointer buttons are used with no modifiers, and 
when they are used with the "shift" key. The assignment of the functions described below to keys 
and buttons may be changed through the resource database; see ACTIONS below. 

Pointer button one (usually left) is used to save text into the cut buffer. Move the cursor to begin- 
ning of the text, and then hold the button down while moving the cursor to the end of the region 
and releasing the button. The selected text is highlighted and is saved in the global cut buffer and 
made the PRIMARY selection when the button is released. Double-clicking selects by words. 
Triple-clicking selects by lines. Quadruple-clicking goes back to characters, etc. Multiple-click is 
determined by the time from button up to button down, so you can change the selection unit in the 
middle of a selection. If the key/button bindings specify that an X selection is to be made, xterm 
will leave the selected text highlighted for as long as it is the selection owner. 

Pointer button two (usually middle) 'types' (pastes) the text from the PRIMARY selection, if any, 
otherwise from the cut buffer, inserting it as keyboard input. 

Pointer button three (usually right) extends the current selection. (Without loss of generality, that 
is you can swap "right" and "left" everywhere in the rest of this paragraph...) If pressed while 
closer to the right edge of the selection than the left, it extends/contracts the right edge of the 
selection. If you contract the selection past the left edge of the selection, xterm assumes you really 
meant the left edge, restores the original selection, then extends/contracts the left edge of the 
selection. Extension starts in the selection unit mode that the last selection or extension was per- 
formed in; you can multiple-click to cycle through them. 

By cutting and pasting pieces of text without trailing new lines, you can take text from several 
places in different windows and form a command to the shell, for example, or take output from a 
program and insert it into your favorite editor. Since the cut buffer is globally shared among 
different applications, you should regard it as a 'file' whose contents you know. The terminal 
emulator and other text programs should be treating it as if it were a text file, i.e. the text is delim- 
ited by new lines. 

The scroll region displays the position and amount of text currently showing in the window 
(highlighted) relative to the amount of text actually saved. As more text is saved (up to the max- 
imum), the size of the highlighted area decreases. 

Clicking button one with the pointer in the scroll region moves the adjacent line to the top of the 
display window. 

Clicking button three moves the top line of the display window down to the pointer position. 

Clicking button two moves the display to a position in the saved text that corresponds to the 
pointer's position in the scrollbar. 
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Unlike the VT102 window, the Tektronix window dows not allow the copying of text. It does allow 
Tektronix GIN mode, and in this mode the cursor will change from an arrow to a cross. Pressing 
any key will send that key and the current coordinate of the cross cursor. Pressing button one, 
two, or three will return the letters '1', 'm', and 'r', respectively. If the 'shift' key is pressed when a 
pointer button is pressed, the corresponding upper case letter is sent. To distinguish a pointer 
button from a key, the high bit of the character is set (but this is bit is normally stripped unless the 
terminal mode is RAW; see ttyiA) for details). 

MENUS 

Xterm has four menus, named mainMenu, vtMenu , fontMenu , and tekMenu. Each menu pops up 
under the correct combinations of key and button presses. Most menus are divided into two sec- 
tion, separated by a horizontal line. The top portion contains various modes that can be altered. 
A check mark appears next to a mode that is currently active. Selecting one of these modes tog- 
gles its state. The bottom portion of the menu are command entries; selecting one of these per- 
forms the indicated function. 

The xterm menu pops up when the "control" key and pointer button one are pressed in a window. 
The mainMenu contains items that apply to both the VT102 and Tektronix windows. The Secure 
Keyboard mode is be used when typing in passwords or other sensitive data in an unsecure 
environment; see SECURITY below. Notable entries in the command section of the menu are the 
Continue, Suspend, Interrupt, Hangup, Terminate and Kill which sends the SIGCONT, SIGTSTP, 
SIGINT, SIGHUP, SIGTERM and SIGKILL signals, respectively, to the process group of the pro- 
cess running under A^emi (usually the shell). The Continue function is especially useful if the user 
has accidentally typed CTRL-Z, suspending the process. 

The VtMenu sets various modes in the VT102 emulation, and is popped up when the "control" key 
and pointer button two are pressed in the VT102 window. In the command section of this menu, 
the soft reset entry will reset scroll regions. This can be convenient when some program has left 
the scroll regions set incorrectly (often a problem when using VMS or TOPS-20). The full reset 
entry will clear the screen, reset tabs to every eight columns, and reset the terminal modes (such as 
wrap and smooth scroll) to their initial states just atttr xterm has finished processing the command 
line options. 

The fontMenu sets the font used in the VT102 window. 

The tekMenu sets various modes in the Tektronix emulation, and is popped up when the "control" 
key and pointer button two are pressed in the Tektronix window. The current font size is checked 
in the modes section of the menu. The PAGE entry in the command section clears the Tektronix 
window. 

SECURITY 

X environments differ in their security consciousness. MIT servers, run under xdm, are capable of 
using a "magic cookie" authorization scheme that can provide a reasonable level of security for 
many people. If your server is only using a host-based mechanism to control access to the server 
(see xhostiiy), then if you enable access for a host and other users are also permitted to run 
clients on that same host, there is every possibility that someone can run an application that will 
use the basic services of the X protocol to snoop on your activities, potentially capturing a tran- 
script of everything you type at the keyboard. This is of particular concern when you want to type 
in a password or other sensitive data. The best solution to this problem is to use a better authori- 
zation mechanism that host-based control, but a simple mechanism exists for protecting keyboard 
in^ut in xterm. 

The xterm menu (see MENUS above) contains a Secure Keyboard entry which, when enabled, 
ensures that all keyboard input is directed only to xterm (using the GrabKeyboard protocol 
request). When an application prompts you for a password (or other sensitive data), you can 
enable Secure Keyboard using the menu, type in the data, and then disable Secure Keyboard using 
the menu again. Only one X client at a time can secure the keyboard, so when you attempt to 
enable Secure Keyboard it may fail. In this case, the bell will sound. If the Secure Keyboard 
succeeds, the foreground and background colors will be exchanged (as if you selected the Reverse 
Video entry in the Modes menu); they will be exchanged again when you exit secure mode. If the 
colors do not switch, then you should be very suspicious that you are being spoofed. If the applica- 
tion you are running displays a prompt before asking for the password, it is safest to enter secure 
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mode before the prompt gets displayed, and to make sure that the prompt gets displayed correctly 
(in the new colors), to minimize the probability of spoofing. You can also bring up the menu 
again and make sure that a check mark appears next to the entry. 

Secure Kqi)oard mode will be disabled automatically if your xterm window becomes iconified (or 
otherwise unmapped), or if you start up a reparenting window manager (that places a title bar or 
other decoration around the window) while in Secure Keyboard mode. (This is a feature of the X 
protocol not easily overcome.) When this happens, the foreground and background colors will be 
switched back and the bell will sound in warning. 

CHARACTER CLASSES 

Clicking the middle mouse button twice in rapid succession will cause all characters of the same 
class (e.g. letters, white space, punctuation) to be selected. Since different people have different 
preferences for what should be selected (for example, should filenames be selected as a whole or 
only the separate subnames), the default mapping can be overridden through the use of the char- 
Class (class CharClass) resource. 

This resource is simply a list of rangewalue pairs where the range is either a single number or 
low-high in the range of to 127, corresponding to the ASCII code for the character or characters 
to be set. The value is arbitrary, although the default table uses the character number of the first 
character occurring in the set. 

The default table is: 

static int charClass[128] = { 

/» NUL SOH STX ETX EOT ENQ ACK BEL */ 

32 1111111 
/• BS Ht' NL VT ' NP CR SO SI */ 

1 32 111111 
/• DLEDCl DC2 DC3 DOt NAK SYN ETB */ 

1, 1, 1, 1, 1, 1, 1, 1, 
/* CAN EM SUB esc' FS GS RS US '/ 

1, 1, 1, 1, 1, 1, 1, 1, 
/* SP !"#$%& '7 
32, 33, 34, 35, 36, 37, 38, 39, 

/*()* + ,-•/•/ 

40, 41, 42, 43, 44, 45, 46, 47, 
/* 01234567*/ 

48, 48, 48, 48, 48, 48, 48, 48, 
/* 8 9 : ; < = > ? */ 

48, 48, 58, 59, 60, 61, 62, 63, 
/*@ABCDEFGV 

64, 48, 48, 48, 48, 48, 48, 48, 
/*HIJKLMNO*/ 

48, 48, 48, 48, 48, 48, 48, 48, 
/*PQRSTUVW*/ 

48, 48, 48, 48, 48, 48, 48, 48, 
/* X Y Z [ \ ] - _V 

48, 48, 48, 91, 92, 93, 94, 48, 
/* ' a b c d e f gV 

96, 48, 48, 48, 48, 48, 48, 48, 
/* h i j k 1 m n o*/ 

48, 48, 48, 48, 48, 48, 48, 48, 
/*pqrstuvw*/ 

48, 48, 48, 48, 48, 48, 48, 48, 
/* X y z { I } - DEL*/ 

48, 48, 48, 123, 124, 125, 126, 1}; 

For example, the string "33:48,37:48,45-47:48,64:48" indicates that the exclamation mark, percent 
sign, dash, period, slash, and ampersand characters should be treated the same way as characters 

Hewlett-Packard Company - 13 - X Window System Release 4 



XTERM(l) XTERM(l) 



and numbers. This is vety useful for cutting and pasting electronic mailing addresses and 
filenames. 

ACTIONS 

It is possible to rebind keys (or sequences of keys) to arbitrary strings for input, by changing the 
translations for the vtlOO or tek4014 widgets. Changing the translations for events other than key 
and button events is not expected, and will cause unpredictable behavior. The following actions 
are provided for using within the vtiOO or tek4014 translations resources: 

h(il\(\perceni\) 

This action rings the keyboard bell at the specified percentage above or below the base 
volume. 

ignoreO This action ignores the event but checks for special pointer position escape sequences. 

insertQ This action is a synonym for insert-seven-bit() 

insert-seven-bit() 

This action inserts the character or string associated with the keysym that was pressed. 
The character or string is obtained using the standard interpretation of Shift, Lock and 
group modifiers as defined by the X Protocol Specification. 

insert-eight-bit() 

This action is the same as insert-seven-bit () except that single characters obtained using 
the standard interpretation are modified according to the resource, eightBitlnput. 

insert-selection(50Mrcena/nf [, ...]) 

This action inserts the string found in the selection or cutbufFer indicated by sourcename. 
Sources are checked in the order given (case is significant) until one is found. 
Commonly-used selections include: PRIMARY, SECONDARY, and CLIPBOARD. Cut 
buffers are typically named CUTBUFFERO through CUTBUFFER?. 

keymap(name) 

This action dynamically defines a new translation table whose resource name is name 
with the suffix Keymap (case is significant). The name None restores the original trans- 
lation table. 

popup^menu{menuname) 

This action displays the specified popup menu. Valid names (case is significant) include: 
mainMenu, vtMenu, fontMenu, and tekMenu. 

secureO This action toggles the Secure Keyboard mode described in the section named SECU- 
RITY, and is invoked from the securekbd entry in mainMenu. 

select-start 

This action begins text selection at the current pointer location. See the section on 
POINTER USAGE for information on making selections. 

select-extend() 

This action tracks the pointer and extends the selection. It should only be bound to 
Motion events. 

sileei-eaAidestname [, .~]) 

This action puts the currently selected text into all of the selections or cutbuffers 
specified by destname. 

select-cursor-startO 

This action is similar to select-start except that it begins the selection at the current text 
cursor position. 

select-cursor-end(rfe5ma/ne [, ~.]) 

This action is similar to select-end except that it should be used with select-cursor-start. 

set-vt-fontid/l/2/3/4/e/s [/tormalfont [, boldfont]]) 

This action sets the font or fonts currently being used in the VT102 window. The first 
argument is a single character that specifies the font to be used: d ot D indicate the 
default font (the font initially used when xterm was started), 1 through 4 indicate the 
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fonts specified by the fontl through /om-/ resources, e or £ indicate the normal and bold 
fonts that may be set through escape codes (or specified as the second and third action 
arguments, respectively), and / or / indicate the font selection (as made by programs such 
as xfontsel(l)) indicated by the second action argument. 

start-extend() 

This action is similar to select-start except that the selection is extended to the current 
pointer location. 

start-cursor-extend() 

This action is similar to select-extend except that the selection is extended to the current 
text cursor position. 

stringistring) 

This action inserts the specified text string as if it had been typed. Quotation is necessary 
if the string contains whitespace or non-alphanumeric characters. If the string argument 
begins with the characters "Ox", it is interpreted as a hex character constant. 

scroIl-back(cou/i; [^nits]) 

This action scrolls the text window backward so that text that had previously scrolled off 
the top of the screen is now visible. The count argument indicates the number of units 
(which maybe page, haljpage, pixel, or line) by which to scroll. 

scroll-forw(coMn/ [^nits]) 

This action scrolls is similar to scroll-back except that it scrolls the other direction. 

allow-send-events(o«/oj57to^/e) 

This action set or toggles the allowSendEvents resource and is also invoked by the 
allowsends entry in mainMenu. 

set-loggingion/ojf/toggle) 

This action toggles the logging resource and is also invoked by the logging entry in main- 
Menu. 

redrawO 

This action redraws the window and is also invoked by the redraw entry in mainMenu. 

send-signal(signame) 

This action sends the signal named by sifftame (which may also be a number) to the 
xterm subprocess (the shell or program specified with the -e command line option) and is 
also invoked by the suspend, continue, interrupt, hangup, terminate, and kill entries in 
mainMenu. Allowable signal names are (case is not significant): suspend, tstp (if sup- 
ported by the operating system), cont (if supported by the operating system), int, hup, 
term, and kill. 

quit() This action sends a SIGHUP to the subprogram and exits. It is also invoked by the quit 
entry in mainMenu. 

s^-scrol\har{on/ojf/ toggle) 

This action toggles the scrollbar resource and is also invoked by the scrollbar entry in 
vtMenu. 

set-jimipscrollion /off/ toggle) 

This action toggles the jumpscroU resource and is also invoked by the juntpscroU entry 
in VtMenu. 

s^-reverse-video{on /off/ toggle) 

This action toggles the reverseVideo resource and is also invoked by the reversevideo 
entry in vtMenu. 

set-autowrap(on /off/ toggle) 

This action toggles automatic wrapping of long lines and is also invoked by the autowrap 
entry in vtMenu. 

set-reversewrap{on /off/ toggle) 

This action toggles the reverseWrap resource and is also invoked by the reversewrap 

entry in vtMenu. 
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set-autolinefeed {on /ojf /toggle) 

This action toggles automatic insertion of linefeeds and is also invoiced by the auto- 
linefeed entry in vtMenu. 

set-appcursor(on /off /toggle) 

This action toggles the handling Application Cursor Key mode and is also invoked by the 
Bappcursor entry in vtMenu. 

set-appkeypad (on /off/ toggle) 

This action toggles the handling of Application Keypad mode and is also invoked by the 
appkeypad entry in vtMenu. 

set-scroll-on-key(on /off/ toggle) 

This action toggles the scrolIKey resource and is also invoked from the scrollkey entry in 
VtMenu. 

set-scro\l-on-tty-output{on /off/ toggle) 

This action toggles the scroIITtyOutput resource and is also invoked from the scrollt- 
tyoutput entry in vtMenu. 

set-allo\¥l$2(on /off/ toggle) 

This action toggles the cl32 resource and is also invoked from the allowl32 entty in 
VtMenu. 

set-cursesemal(on /off/ toggle) 

This action toggles the curses resource and is also invoked from the curses«mul entry in 
VtMenu. 

set-visaal-bell(on /off/ toggle) 

This action toggles the visualBell resource and is also invoked by the visualbell entry in 
VtMenu. 

set-mar2\vbell(on /off/ toggle) 

This action toggles the marginBell resource and is also invoked from the marginbell 
entry in vtMenu. 

s^-altscreen(on /off/ toggle) 

This action toggles between the alternative and current screens. 

soft-reset() 

This action resets the scrolling region and is also invoked from the softreset entry in 
VtMenu. 

hard-reset() 

This action resets the scrolling region, tabs, window size, and cursor keys and clears the 
screen. It is also invoked from the hardreset entry in vtMenu. 

set-terminal-type(type) 

This action directs output to either the \t or tek windows, according to the type string. It 
is also invoked by the tekmode entry in vtMenu and the vtmode entry in tekMenu. 

set-visihility(yt/tekfin/off/toggle) 

This action controls whether or not the vt or tek windows are visible. It is also invoked 
from the tekshow and vthide entries in vtMenu and the vtshow and tekhide entries in tek- 
Menu. 

set-tek-text (large /2/3 /small) 

This action sets font used in the Tektronix window to the value of the resources tek- 
textlai^e, tektext2, tektext3, and tektextsmall according to the argument. It is also by the 
entries of the same names as the resources in tekMenu. 

tek-page() 

This action clears the Tektronix window and is also invoked by the tekpage entry in tek- 
Menu. 

tek-reset() 

This action resets the Tektronix window and is also invoked by the tekreset entry in 
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tekMenu. 

tek-copyO 

This action copies the escape codes used to generate the current window contents to a 
file in the current directory beginning with the name COPY. It is also invoked from the 
tekcopy entry in tekMenu. 

The Tektronix window also has the following action: 

gin-press(//L//M/A//r/i?) 

This action send the indicated graphics input code. 

The default bindings in the VT102 window are: 



Shift <KeyPress> Prion 

Shift <KeyPress> Next: 

Shift <KeyPress> Select: 

Shift <KeyPress> Insert: 
"Meta < KeyPress > : 
Meta < KeyPress > : 
Ctrl "Meta<BtnlDown>: 
'Meta <BtnlDown>: 
"Meta <BtnlMotion>: 
Ctrl "Meta <Btn2Down>: 
"Ctrl "Meta <Btn2Down>: 
"Ctrl "Meta <Btn2Up>: 
Ctrl 'Meta <Btn3Down>: 
'Ctrl "Meta <Btn3Down>: 
'Meta <Btn3Motion>: 
'Ctrl 'Meta <BtnUp>: 
<BtnDown>: 



scroll-back(l,halfpage) \n\ 

scroll-forw(l,halfpage) \n\ 

select-cursor-start() \ 

select-cursor-end(PRIMARY, CUTBUFFERO] 

insert-selection(PRIMARY, CUTBUFFERO) \ 

insert-seven-bit() \n\ 

insert-eight-bit() \n\ 

popup-menu(mainMenu) \n\ 

select-startQ \n\ 

select-extendQ \n\ 

popup-menu(vtMenu) \n\ 

ignoreO \n\ 

insert-selection(PRIMARY, CUTBUFFERO) \ 

popup-menu(fontMenu) \n\ 

start-extend() \n\ 

select-extendQ \n\ 

select-end(PRIMARY, CUT BUFFERO) \n\ 

bell(O) 



The default bindings in the Tektronix window are: 

'Meta < KeyPress > : 

Meta < KeyPress > : 
Ctrl 'Meta<BtnlDown>: 
Ctrl 'Meta <Btn2Down>: 
Shift 'Meta<BtnlDown>: 

' Meta < BtnlDown > : 
Shift 'Meta < Btn2Down > : 

'Meta < Btn2Down > : 
Shift "Meta<Btn3Down>: 

" Meta < Btn3Down > : 



insert-seven-bit() \n\ 
insert-eight-bit()\n\ 
popup-menu(mainMenu) \n\ 
popup-menu(tekMenu) \n\ 
gin-press(L) \n\ 
gin-press(l) \n\ 
gin-press(M) \n\ 
gin-press(m) \n\ 
gin-press(R) \n\ 
gin-press(r) 



Below is a sample how of the keymapO action is used to add special keys for entering commonly- 
typed works: 

*VT100.Translations: #override <Key>F13: keymap(dbx) 

♦VTlOO.dbxKeymap.translations: \ 

<Key>F14: keymap(None) \n\ 

<Key>F17: stringCnext") string(OxOd) \n\ 

<Key>F18: string("step") string(OxOd) \n\ 

<Key>F19: string("continue") string(OxOd) \n\ 

< Key > F20: string("print ") insert-selection(PRIMARY, CUTBUFFERO) 

OTHER FEATURES 

Xterm automatically highlights the window border and text cursor when the pointer enters the 
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window (selected) and unhighlights them when the pointer leaves the window (unselected). If the 
window is the focus window, then the window is highlighted no matter where the pointer is. 

In VT102 mode, there are escape sequences to activate and deactivate an alternate screen buffer, 
which is the same size as the display area of the window. When activated, the current screen is 
saved and replace with the alternate screen. Saving of lines scrolled off the top of the window is 
disabled until the normal screen is restored. The termcapiS) entry iotxterm allows the visual edi- 
tor VI (1) to switch to the alternate screen for editing, and restore the screen on exit. 

In either VT102 or Tektronix mode, there are escape sequences to change the name of the win- 
dows and to specify a new log file name. 

ENVIRONMENT 

Xterm sets the environment variables "TERM" and "TERMCAP" properly for the size window 
you have created. It also uses and sets the environment variable "DISPLAY" to specify which bit 
map display terminal to use. The environment variable "WINDOWID" is set to the X window id 
number of the xterm window. 

SEE ALSO 

resize(l),X(l),pty(4),tty(4) 
Xterm Control Sequences 

BUGS 

The Xterm Control Sequences document has yet to be converted from XIO. The old version, along 
with a first stab at an update, are available in the sources. 

The class name is XTerm instead oi Xterm. 

Xterm will hang forever if you try to paste too much text at one time. It is both producer and con- 
sumer for the pty and can deadlock. 

Variable-width fonts are not handled. 

This program still needs to be rewritten. It should be split into very modular sections, with the 
various emulators being completely separate widgets that don't know about each other. Ideally, 
you'd like to be able to pick and choose emulator widgets and stick them into a single control 
widget. 

The focus is considered lost if some other client (e.g., the window manager) grabs the pointer; it is 
difficult to do better without an addition to the protocol. 

There needs to be a dialog box to allow entry of log file name and the COPY file name. 

Many of the options are not resettable aii&r xterm starts. 

The Tek widget does not support key/button re-binding. 

COPYRIGHT 

Copyright 1989, Massachusetts Institute of Technolo^. 
See X(l) for a full statement of rights and permissions. 

AUTHORS 

Far too many people, including: 

Loretta Guarino Reid (DEC-UEG-WSL), Joel McCormack (DEC-UEG-WSL), Terry Weissman 
(DEC-UEG-WSL), Edward Moy (Berkeley), Ralph R. Swick (MIT-Athena), Mark Vandevoorde 
(MIT-Athena), Bob McNamara (DEC-MAD), Jim Gettys (MIT-Athena), Bob Scheifler (MIT X 
Consortium), Doug Mink (SAO), Steve Pitschke (Stellar), Ron Newman (MIT-Athena), Jim Ful- 
ton (MIT X Consortium), Dave Serisky (HP) 
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NAME 

XTERM control sequences 

DESCRIPTION 

The xterm program, a terminal emulator for the X Window System, provides DEC VT102 and 
Tektronix 4014 terminal emulation. 

Since the terminals being emulated respond to escape sequences, xterm also responds to escape 
sequences. The sequences listed here include those appropriate for both terminal emulation 
modes. 

Definitions 

C A single (required) character. 

Pg A single (usually optional) numeric parameter, composed of one of more 

digits. 

Pf„ A multiple numeric parameter composed of any number of single numeric 

parameters, separated by ; character(s). 

Pf A text parameter composed of printable characters. 

Vri02 Mode 

Most of these control sequences are standard VT102 control sequences. There are, however, 
additional ones to provide control oixterm dependent functions, like the scrollbar or window size. 

BEL Bell (Ctri-G) 

BS Backspace (Ctri-H) 

TAB Horizontal Tab (Ctri-I) 

LF Line Feed or New Line (Ctri-J) 

VT Vertical Tab (Ctrl-K) 

FF Form Feed or New Page (Ctri-L) 

CR Carriage Return (Ctri-M) 

50 Shift Out (Ctri-N) -+ Switch to Alternate Character Set 

51 Shift In (Ctri-O) -♦ Switch to Standard Character Set 
ESC # 8 DEC Screen Alignment Test (DECALN) 

ESC ( C Select GO Character Set (SCS) 

C = — » Special Character and Line Drawing Set 

C = A -> United Kingdom (UK) 

C = B -► United States (USASCII) 
ESC ) C Select Gl Character Set (SCS) 

C = — » Special Character and Line Drawing Set 

C = A -> United Kingdom (UK) 

C = B -f United States (USASCII) 
ESC * C Select G2 Character Set (SCS) 

C = — ► Special Character and Line Drawing Set 

C = A -» United Kingdom (UK) 

C = B -* United States (USASCII) 
Select G3 Character Set (SCS) 

C = — »^ Special Character and Line Drawing Set 

C = A -f United Kingdom (UK) 

C = B -» United States (USASCII) 
Save Cursor (DECSC) 
Restore Cursor (DECRC) 
Application Keypad (DECPAM) 
Normal Keypad (DECPNM) 
Index (IND) 
Next Line (NEL) 
Tab Set (HTS) 
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ESC + 


C 


ESC 7 




ESC 8 

TJQ.C — 




EOV^ — 

ESC > 




ESC D 




ESC E 




ESC H 
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ESC M 
ESC N 
ESC O 
ESC Z 
ESC [ P, @ 
ESC [ij A 
ESC [P, B 
ESC [P, C 
ESC [P, D 
ESC [ P, ; P, 
ESC [ P, J 



ESC [P, K 



ESC [ P, L 
ESC [ P, M 
ESC [ P, P 
ESC [P, c 
ESC [ P, ; P, 
ESC [ P, g 



ESC [P, h 



ESC [P, 1 



ESC [ P^ m 



ESC [P, n 



ESC [ P, ; P, r 

ESC [ij X 
ESC [ ? /J h 



Reverse Index (RI) 

Single Shift Select of G2 Character Set (SS2) 

Single Shift Select of G3 Character Set (SS3) 

Return Terminal ID (DECID) 

Insert /J (Blank) Character(s) (default = 1) (ICH) 

Cursor UpiJ Times (default = 1) (CUU) 

Cursor Down ij Times (default = 1) (CUD) 

Cursor Forward ^ Times (default = 1) (CUF) 

Cursor Backward ij Times (default = 1) (CUB) 

Cursor Position [row;column] (default = [1,1]) (CUP) 

Erase in Display (ED) 

ij = -► Clear Below (default) 

i^ = l-» Clear Above 

P, = 2 -» Clear All 
Erase in Line (EL) 

P, = -► Qear to Right (default) 

P, = 1 -» Clear to Left 

Pj = 2 -f Clear All 
Insert /J Line(s) (default = 1) (IL) 
Delete /J Line(s) (default = 1) (DL) 
Delete P, Character(s) (default = 1) (DCH) 
Device Attributes (default 0) (DA) 

Horizontal and Vertical Position [row;column] (default = [1,1]) (HVP) 
Tab Clear 

/J = -+ Clear Current Column (default) 

P, =3 -►Clear All 
Mode Set (SET) 

P, = 4 -f Insert Mode (IRM) 

/J = 20 -+ Automatic Linefeed (LNM) 
Mode Reset (RST) 

Pj = 4 -» Insert Mode (IRM) 

P^ = 20 -+ Automatic Linefeed (LNM) 
Character Attributes (SGR) 

P, = -» Normal (default) 

ij = 1 — > Blink (appears as Bold) 

P^ = 4 — f Underscore 

P, =5 -♦Bold 

P^ = 7 — » Inverse 
Device Status Report (DSR) 

P, =5-* Status Report ESC [ On -> OK 

ij =6-* Report Cursor Position (CPR) [row;column] as ESC [ r; cR 
Set Scrolling Region [top;bottom] (default = full size of window) 
(DECSTBM) 

Request Terminal Parameters (DECREQTPARM) 
DEC Private Mode Set (DECSET) 

i^ = 1 -♦ Application Cursor Keys (DECCKM) 

P, = 3 -► 132 Column Mode (DECCOLM) 

P, =4-* Smooth (Slow) Scroll (DECSCLM) 

P, = 5 -♦ Reverse Video (DECSCNM) 

P, =6-^ Origin Mode (DECOM) 

/J = 7 -> Wraparound Mode (DECAWM) 

P, =8-* Auto-repeat Keys (DECARM) 

P, =9-y Send MIT Mouse Row & Column on Button Press 

Pj = 38 -► Enter Tektronix Mode (DECTEK) 

p^ = 40 -f Allow 80^132 Mode 

ij = 41 — ► curses(5) fix 

i> =44 -►Turn On Margin Bell 

/J = 45 — ♦ Reverse-wraparound Mode 
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i> = 46 — » Start Lx)gging 

/> = 47 -+ Use Alternate Screen Buffer 

/J = 1000 -» Send VT200 Mouse Row & Column on Button Press 

ij = 1003 ->■ Send VT200 Hilite Mouse Row & Column on Button Press 
ESC [ ? ij 1 DEC Private Mode Reset (DECRST) 

ij = 1 -► Normal Cursor Keys (DECCKM) 

P, =3 — 80 Column Mode (DECCOLM) 

ij = 4 -^ Jump (Fast) Scroll (DECSCLM) 

P, = 5 -» Normal Video (DECSCNM) 

/> = 6 -♦ Normal Cursor Mode (DECOM) 

P, = 7 -► No Wraparound Mode (DECAWM) 

P, = 8 -► No Auto-repeat Keys (DECARM) 

/J = 9 — »^ Don't Send Mouse Row & Column on Button Press 

/> = 40 -H- Disallow 80 <-♦ 132 Mode 

ij = 41 -+ No curses(5) fix 

i> = 44 -+ Turn Oflf Margin Bell 

Pg = 45 — ► No Reverse-wraparound Mode 

P^ = 46 — » Stop Logging 

jp = 47 -»^ Use Normal Screen Bufifer 

/J = 1000 -» Don't Send Mouse Row & Column on Button Press 

P^ = 1003 -► Don't Send Mouse Row & Column on Button Press 
ESC [ ? P^ r Restore DEC Private Mode 

JP = 1 -► Normal/Application Cursor Keys (DECCKM) 

ij = 3 -♦ 80/132 Column Mode (DECCOLM) 

i> = 4 -+ Jump (Fast)/Smooth (Slow) Scroll (DECSCLM) 

JP = 5 -► Normal/Reverse Video (DECSCNM) 

i> = 6 -♦ Normal/Origin Cursor Mode (DECOM) 

i> = 7 -» No Wraparound/Wraparound Mode (DECAWM) 

ij = 8 -+ Auto-repeat/No Auto-repeat Keys (DECARM) 

ij = 9 -» Don't Send/Send MIT Mouse Row & Column on Button 
Press 

i> = 40 -» Disallow/Allow 80 ♦-+ 132 Mode 

P, = 41 -f Off/On curses(5) fix 

P, = 44 -♦ Turn Off/On Margin Bell 

P^ = 45 — » No Reverse-wraparound/Reverse-wraparound Mode 

P^ = 46 — ► Stop/Start Logging 

P^ = 47 — ► Use Normal/Alternate Screen Buffer 

P^ = 1000 -► Don't Send/Send VT220 Mouse Row & Column on Button 
Press 

P^ = 1003 -» Don't Send/Send VT220 Hilite Mouse Row & Column on 
Button Press 
ESC [ ? i^ s Save DEC Private Mode 

ij = 1 -> Normal/Application Cursor Keys (DECCKM) 

/J = 3 -► 80/132 Column Mode (DECCOLM) 

P, =4-* Jump (Fast)/Smooth (Slow) Scroll (DECSCLM) 

P, = 5 -► Normal/Reverse Video (DECSCNM) 

i> = 6 -► Normal/Origin Cursor Mode (DECOM) 

i> = 7 -f No Wraparound/Wraparound Mode (DECAWM) 

ij = 8 -♦ Auto-repeat/No Auto-repeat Keys (DECARM) 

ij = 9 -* Don't Send/Send MIT Mouse Row & Column on Button 
Press 

i> = 40 -» Disallow/Allow 80 ^ 132 Mode 

i> = 41 -» Off/On CM>se^(5) fix 

i> = 44 -♦ Turn Off/On Margin Bell 

P^ = 45 — » No Reverse-wraparound/ Reverse-wraparound Mode 

/> = 46 -+ Stop/Start Logging 

Pg =41—* Use Normal/Alternate Screen Buffer 

P^ = 1000 -* Don't Send/Send VT220 Mouse Row & Column on Button 
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Press 

/J = 1003 -► Don't Send/Send VT220 Hilite Mouse Row & Column on 
Button Press 
ESC ] Ps ; P, BEL Set Text Parameters 

ij = — » Change Icon Name and Window Title to P^ 

ij = 1 — » Change Icon Name toP, 

P, = 2 -f Change Window Title to P, 

P, = 46 -» Change Log File to i? 
ESC c Full Reset (RIS) 

ESC n Locking Shift Select of G2 Character Set (LS2) 

ESC o Locking Shift Select of G3 Character Set (LS3) 

Tektronix 4015 Mode 

Most of these sequences are standard Tektronix 4015 control sequences. The major features miss- 
ing are the alternate (APL) character set and the write-thru and defocused modes. 

BEL Bell (Ctrl-G) 

BS Backspace (Ctrl-H) 

TAB Horizontal Tab (Ctrl-I) 

LF Line Feed or New Line (Ctrl-J) 

VT Vertical Tab (Ctrl-K) 

FF Form Feed or New Page (Ctrl-L) 

CR Carriage Return (Ctrl-M) 

ESC ETX Switch to VT102 Mode 

ESC ENQ Return Terminal Status 

ESC LF PAGE (Clear Screen) 

ESC ETB COPY (Save Tektronix Codes to File) 

ESC CAN Bypass Condition 

ESC SUB GIN mode 

ESC FS Special Point Plot Mode 

ESC GS Graph Mode (same as GS) 

ESC RS Incremental Plot Mode (same as RS) 

ESC US Alpha Mode (same as US) 

ESC 8 Select Large Character Set 

ESC 9 Select #2 Character Set 

ESC : Select #3 Character Set 

ESC ; Select Small Character Set 

ESC ] Ps ; Pf BEL Set Text Parameters 

ij = — »• Change Icon Name and Window Title to P, 

P^ = 1 — ► Change Icon Name to /J 

P^ = 2 -► Change Window Title to ij 

ij = 46 -f Change Log File to P, 

ESC ' Normal Z Axis and Normal (solid) Vectors 

ESC a Normal Z Axis and Dotted Line Vectors 

ESC b Normal Z Axis and Dot-Dashed Vectors 

ESC c Normal Z Axis and Short-Dashed Vectors 

ESC d Normal Z Axis and Long-Dashed Vectors 

ESC h Defocused Z Axis and Normal (solid) Vectors 

ESC i Defocused Z Axis and Dotted Line Vectors 

ESC j Defocused Z Axis and Dot-Dashed Vectors 

ESC k Defocused Z Axis and Short-Dashed Vectors 

ESC 1 Defocused Z Axis and Long-Dashed Vectors 

ESC p Write-Thru Mode and Normal (solid) Vectors 

ESC q Write-Thru Mode and Dotted Line Vectors 

ESC r Write-Thru Mode and Dot-Dashed Vectors 

ESC s Write-Thru Mode and Short-Dashed Vectors 

ESC t Write-Thru Mode and Long-Dashed Vectors 

FS Point Plot Mode 
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GS Graph Mode 

RS Incremental Plot Mode 

US Alpha Mode 
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HP-UX and OSF/1 Only 

N>\ME 

xwcreate - create a new X window 

SYNOPSIS 

xwcreate [options] name 

DESCRIPTION 

This command creates a new X window and assigns it the name name. 

This program will also create a device file of the same name as the window in the indicated direc- 
tory. After the window has been created, the device file maybe used to specify the window that an 
application should use when utilizing a graphics library (e.g., Starbase or HP-GKS). 

A window created by xwcreate can be destroyed by xwdestroy{l). 

OPTIONS 

-display display 

Specifies the server to connect to; See X{1) for details. A limitation in xwcreate requires 
that the display name must be no more than 115 characters long. 

-parent parent 

Name of the window which is to be the parent of name. If named, the parent window 
must have been created by a previous invocation ol xwcreate and must not have been des- 
troyed hyxwdestroyil); otherwise an error message will be generated. If parent Avindow is 
not named, the RootWindow of the display and screen will be used as the parent. If 
specified, parent window's name must be no more than 12 characters long. 

-geometry geometry 

This option specifies the preferred size and position of the window; SeeX(i) for details. 

-r Requests the X server to create backing store for the window. By default, windows are 

not created with backing store. 

-bg color 

This option specifies the background color. By default, background color of the window 
will be black. 

-bw pixels 

This option specifies the width in pixels of the window border. By default, border of the 
window will be 3 pixels wide. 

-bd color 

This option specifies the border color. By default, the window border will be white. 

-depth depth 

This option specifies the visual depth of the window. By default, the window will have the 
same depth as its parent. If the specified depth is not supported by the display, an error 
will be generated and the window will not be created. 

-visual visualclass 

This option specifies the visual class of the window when multiple visual classes are sup- 
ported by the display at the specified depth, visualclass can be TseudoColor", "Sta- 
ticODlor", "Grayscale", "StaticGray", "DirectColor" or TrueColor" (case is not significant). 
For most displays, which support only one visual class at each depth, this option need not 
be specified. 

-overlay 

This option specifies that an overlay plane visual should be used. This option is only in 
effect for servers that are in the combined mode with the root window property, 
SERVER_OVERLAY_VISUALS set. For such a server, specifying this option will cause 
only overlay visuals to be considered; when this option is not specified, image plane 
based visuals will be favored. 

-wmdir directory 

is the name of the directory where the device file is to be created. See DEPENDEN- 
CIES, below, for details. 
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-title name 

is the name to be used to reference the window. The name must be no more than 12 
characters long. 

X DEFAULTS 

xwcreate uses the Xlib routine XGetDefault{3X) to read its Xdefaults, so its resource names are all 
capitalized. 

Background 

Specifies the window's background color. 

BorderCoIor 

Specifies the border color. This option is useful only on color displays. 

BorderWidth 

Specifies the border width. 

Depth Specifies the visual depth of the created window. 

VisualClass 

Specifies the visual class of the created window. 

Retained 

If 'on', requests the X server to create backing store for the window. 

Wmdir Specifies the default directory where the device file will be created. See -wmdir above for 
details. 

Geometry 

Specifies the default positioning and/or sizing for the created window. See XQ) for 
details. 

EXAMPLES 

xwcreate FullView 

Create a window named "FullView". Since no other argument is provided, the default 
geometry, border color, etc. of FullView will be taken from the RootWindow of the 
windov/s display and screen. 

xwcreate HalfView -display remote_host: 1.2 -parent FullView 
-geometry 400x200 +5 + 10 -r -bw 10 

Create a window named "HalfView" on the display "remote_host:1.2". HalfView will be a 
child of the window "FullView". The upper left hand comer of HalfView will be located at 
coordinate 5,10 of FullView and will be 400 pixels wide and 200 pixels high. The border 
of HalfView will be 10 pixels wide and the border colors will be the same as FullView. 

DEPENDENCIES 

HP-UX Systems 

Windows are actually created, maintained, and destroyed by the gwind daemon; xwcreate 
does its job by requesting window creation from the daemon. If gwind is not running, 
xwcreate will start it. 

The device file created by xwcreate /gwind is apty, through which graphics applications (such 
as the Starbase library) communicate with gwind. 

The location of the device file is determined by the use of the -wmdir command line option 
and the WMDIR environment variable. 

If the -wmdir option is not used, then the directory name will be computed as follows: first, 
the environment of the process will be searched for the variable $WMDIR. If the variable 
$WMDIR is defined in the environment, then it will be used as the desired directory. If the 
variable $WMDIR is not defined in the environment, then the device file will be created in 
the /dev/screen directory. 

If the -wmdir option is used in the command line, the directory name will be obtained as fol- 
lows: If the directory argument implies an absolute pathname, then it will be taken to be the 

Hewlett-Packard Company - 2 - 



XWCREATE(l) XWCREATE(l) 

HP-UX and OSF/1 Onfy 

desired directory. Otherwise, the directory name will be taken to be relative to the value of 
the environment variable $WMDIR. If $WMDIR is not defined in the environment, the 
directory name will be taken to be relative to the /dev/screen directory. Note: if $WMDIR 
is defined in the environment, it must represent an absolute pathname. If -wmdir is defined 
in the command line, then the implied directory must have already been created. Otherwise, 
an error ("Invalid directory") will be generated. 

If -wmdir is used or WMDIR environment variable is set to other than the default, the direc- 
tory used must exist on the same physical device as "/dev". 

If XKillClient is used (used by some window managers) on one of the windows created by 
xwcreate, all xwcreate windows (started with the same "-display" argument) will also be des- 
troyed. 

OSF/1 Systems 

The device file created by xwcrecae is a regular file that identifies the window it has created. 
Graphics applications (such as the Starbase library) use this information to access the win- 
dow. 

The location of the device file is determined by the use of the -wmdir command line option, 
the WMDIR environment variable, and the name parameter. 

If name contains "/", the device file is created relative to the current directory or the root 
directory as appropriate (e.g., "/tmp/device", "./mydevice"). If name does not contain "/", 
the device file is located in a directory determined by the WMDIR environment variable or 
the -wmdir option as follows: 

If WMDIR is not defined and the -wmdir options is not used, the device file is created in the 
/var/screen directory. 

If the WMDIR environment variable is defined or the -wmdir option used (the option over- 
rides the environment variable), the device file is located in the specified directory. 

The name length limitations for window and display names for OSF/1 have changed. The 
maximum name length for name, display, and parent is 1024 characters in the OSF/1 
environment. 

ENVIRONMENT 

DISPLAY - the default host and display number. 

WMDIR - the window manager directory. 

/dev/screen - the default window manager directory on HP-UX systems. 

DIAGNOSTICS 

If the window is created successfully, xwcreate will remain silent. Otherwise xwcreate prints one or 
more error messages to standard output. For example: 

No such display. 

Named window exists. 

Named parent window does not exist. 

Couldn't communicate with gwind. 

NOTES 

The WM_CLASS of an xwcreate'ed window is Xwcreate. 

ORIGIN 

HP 

SEE ALSO 

X(l), XOpenDisplay(3x), xwdestroy(l). 
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NAME 

xwd - dump an image of an X window 

SYNOPSIS 

xwd [-debug] [-help] [-nobdrs] [-out file] [-xy] [-frame] [-add value] [-root | -id id \ -name 
name ] [-screen] [-display displc^] 

DESCRIPTION 

Xwd is an X Window System window dumping utility. Xwd allows X users to store window images 
in a specially formatted dump file. This file can then be read by various other X utilities for 
redisplay, printing, editing, formatting, archiving, image processing, etc. The target window is 
selected by clicking the pointer in the desired window. The keyboard bell is rung once at the 
beginning of the dump and twice when the dump is completed. 

OPTIONS 

-display display 

This argument allows you to specify the server to connect to; see X(J.). 

-help Print out the 'Usage:' command syntax summary. 

-nobdrs This argument specifies that the window dump should not include the pixels that com- 
pose the X window border. This is useful in situations where you may wish to include 
the window contents in a document as an illustration. 

•out file This argument allows the user to ejqilicitly specify the output file on the command line. 
The default is to output to standard out. 

-xy This option applies to color displays only. It selects 'XY' format dumping instead of the 

default 'Z' format. 

-add value 

This option specifies an signed value to be added to every pixel. 

-frame This option indicates that the window manager frame should be included when manually 
selecting a window. 

-root This option indicates that the root window should be selected for the window dump, 
without requiring the user to select a window with the pointer. 

-id id This option indicates that the window with the specified resource id should be selected 
for the window dump, without requiring the user to select a window with the pointer. 

-name name 

This option indicates that the window with the specified WM_NAME property should be 
selected for the window dump, without requiring the user to select a window with the 
pointer. 

-screen This option indicates that the Getlmage request used to obtain the image should be 
done on the root window, rather than directly on the specified window. In this way, you 
can obtain pieces of other windows that overlap the specified window, and more impor- 
tantly, you can capture menus or other popups that are independent windows but appear 
over the specified window. 

ENVIRONMENT 

DISPLAY 

To get default host and display number. 

FILES 

XWDFile.h 

X Window Dump File format definition file. 

SEE ALSO 

xwud(l), xpr(l), X(l) 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See Xil) for a full statement of rights and permissions. 
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AUTHORS 

Tony Delia Fera, Digital Equipment Corp., MIT Project Athena 
William F. Wyatt, Smithsonian Astrophysical Observatory 
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NAME 

xwd2sb - translate xwd bitmap to Starbase bitmap format 

SYNOPSIS 

xwd2sb 

DESCRIPTION 

This command translates a bitmap file created by the xwd(l) X window dump utility program into 
a Starbase bitmap file as described in bitmapfile(4). Translation is done from standard input to 
standard output. 

Bitmaps created by xwd in the XYPixmap format are translated into plane-major full-depth Star- 
base bitmaps. ZPixmc^ format bitmaps are translated into pixel-major Starbase bitmaps. 

Xwd format bitmaps with visual class DueColor or DirectColor are translated into Starbase bit- 
maps with the colormap mode CMAP_FULL. Other visual classes result in Starbase bitmaps with 
the CMAP NORMAL colormap mode. 

Window borders stored by;"^^ are stripped from the image during translation. 

OPTIONS 

none 

EXAMPLES 

xwd I xwd2sb | pcltrans | Ip -craw 

Invokes xwd to dump the contents of a window in ZPixmap format, xwdTsb translates the 
window image into Starbase format, pcltrans prepares the image for printing, and Ip 
spools the image for the printer. 

xwd -xy I xwd2sb > sbimage 

Invokes xwd to dump the contents of a window in XYPixmap format and xwd2sb to 
translate the image into Starbase plane-major full-depth format. The Starbase bitmap 
image is placed in the sbimage file. (Note that pcltrans is unable to process plane-major 
full-depth images.) 

xwd2sb <xwdfile >sbfile 

Translates the image in xwdfile to Starbase format and places the result in sbfile. 

RESTRICTIONS 

XWD bitmaps must be 1-8, 12, or 24 planes deep. Bitmaps of depth 1-8 may have a visual class of 
Grayscale, StaticGray, PseudoColor, or StaticColor. Bitmaps of depths 12 or 24 must be of the 
DirectColor or TrueColor visual class. 

A 12 plane bitmap must have four bits each for red, green, and blue. A 24 plane bitmap must 
have eight bits each for red, green, and blue. 

ORIGIN 

Hewlett-Packard GTD 

SEE ALSO 

xwd(l), pcltrans(l), bitmapfile(4). 

Starbase Graphics Techniques, HP-UX Concepts and Tutorials, chapters on "Color" and "Storing 
and Printing Images". 
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HP-UX and OSF/1 Only 

NAME 

xwdestroy - destroy one or more existing windows 

SYNOPSIS 

xwdestroy [^mndir directoty] windowl window! ~. 

DESCRIPTION 

If a window named in the list was created using AfH'crea^e(l), then it is destroyed, along with its chil- 
dren. Also the device files associated with these windows are removed. 

-wmdir directoty 

is the name of the directory where the device file for the window was created. See the 
xwcreateiX) man page for a description of how this option and the WMDIR environment 
variable are used to locate the device file. 

ENVIRONMENT 

WMDIR - the window manager directory, 
/dev/screen - the default window manager directory. 

DIAGNOSTICS 

If the windows were destroyed successfully, the program remains silent. If one or more of the win- 
dows could not be destroyed because of some error, appropriate message will be printed on stan- 
dard output. For example: 

Invalid directory 

Named window does not exist. 

ORIGIN 

HP 

SEE ALSO 

XOpenDisplay(3), xwcreate(l). 
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NAME 

xwininfo - window information utility for X 

SYNOPSIS 

xwininfo [-help] [-id id] [-root] [-name name] [-int] [-tree] [-stats] [-bits] [-events] [-size] [-wm ] 
[-shape] [-frame] [-all] [-english] [-metric] [-display display] 

DESCRIPTION 

Xwininfo is a utility for displaying information about windows. Various information is displayed 
depending on which options are selected. If no options are chosen, -stats is assumed. 

The user has the option of selecting the target window with the mouse (by clicking any mouse but- 
ton in the desired window) or by specifying its window id on the command line with the -id option. 
Or instead of specifying the window by its id number, the -name option may be used to specify 
which window is desired by name. There is also a special -root option to quickly obtain informa- 
tion on X's root window. 

OPTIONS 

-help Print out the 'Usage:' command syntax summary. 

-id id This option allows the user to specify a target window id on the command line rather 
than using the mouse to select the target window. This is very useful in debugging X 
applications where the target window is not mapped to the screen or where the use of 
the mouse might be impossible or interfere with the application. 

-name name 

This option allows the user to specify that the window named name is the target window 
on the command line rather than using the mouse to select the target window. 

-root This option specifies that X's root window is the target window. This is useful in situa- 
tions where the root window is completely obscured. 

-int This option specifies that all X window ids should be displayed as integer values. The 

default is to display them as hexadecimal values. 

-tree This option causes the root, parent, and children windows' ids and names of the selected 
window to be displayed. 

-stats This option causes the display of various attributes pertaining to the location and appear- 
ance of the selected window. Information displayed includes the location of the window, 
its width and height, its depth, border width, class, colormap id if any, map state, 
backing-store hint, and location of the comers. 

-bits This option causes the display of various attributes pertaining to the selected window's 
raw bits and how the selected window is to be stored. Displayed information includes 
the selected window's bit gravity, window gravity, backing-store hint, backing-planes 
value, backing pixel, and whether or not the window has save-under set. 

-events This option causes the selected window's event masks to be displayed. Both the event 
mask of events wanted by some client and the event mask of events not to propagate are 
displayed. 

-size This option causes the selected window's sizing hints to be displayed. Displayed infor- 
mation includes: for both the normal size hints and the zoom size hints, the user sup- 
plied location if any; the program supplied location if any; the user supplied size if any; 
the program supplied size if any; the minimum size if any; the maximum size if any, the 
resize increments if any; and the minimum and maximum aspect ratios if any. 

-wm This option causes the selected window's window manager hints to be displayed. Infor- 
mation displayed may include whether or not the application accepts input, what the 
window's icon window # and name is, where the window's icon should go, and what the 
window's initial state should be. 

-shape This option causes the selected window's window and border shape extents to be 
displayed if defined. 
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-fk-ame This option causes window manager frames to not be ignored when manually selecting 
windows. 

•metric This option causes all individual height, width, and x and y positions to be displayed in 
millimeters as well as number of pixels, based on what the server thinks the resolution is. 
Geometry specifications that are in +x+y form are not changed. 

-english This option causes all individual height, width, and x and y positions to be displayed in 
inches (and feet, yards, and miles if necessary) as well as number of pixels, -metric and 
-english may both be enabled at the same time. 

-all This option is a quick way to ask for all information possible. 

-display display 

This option allows you to specify the server to connect to; see X{t). 

EXAMPLE 

The following is a sample summary taken with no options specified: 

xwininfo = = > Please select the window about which you 
= = > would like information by clicking the 
= = > mouse in that window. 

xwininfo = = > Window id: 0x60(XX)f (xterm) 

= = > Absolute upper-left X: 4 

= = > Absolute upper-left Y: 19 

= = > Relative upper-left X: 

= = > Relative upper-left Y: 

= = > Width: 726 

= = > Height: 966 

= = > Depth: 4 

= = > Border width: 3 

= = > Window class: InputOutput 

= = > Colormap: 0j«0065 (installed) 

= = > Window Bit Gravity State: NorthWestGravity 

= = > Window Window Gravity State: NorthWestGravity 

= = > Window Backing Store State: NotUseful 

= = > Window Save Under State: no 

= = > Window Map State: IsViewable 

= = > Window Override Redirect State: no 

= = > Comers: +4+19 -640+19 -640-33 +4-33 

ENVIRONMENT 

DISPLAY 

To get the default host and display number. 

SEE ALSO 

X(l),xprop(l) 

BUGS 

Using -stats -bits shows some redundant information. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
SeeX(i) for a full statement of rights and permissions. 

AUTHOR 

Mark Lillibridge, MIT Project Athena 
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NAME 

xwud - image displayer for X 

SYNOPSIS 

xwud [-in file] [-noclick] [-geometry ^o/m] [-display </»p/qy] [-new] [-std <maptype>] [-raw] [- 
vis <vis-type-or-id>] [-help] [-rv] [-plane number] [-fg color] [-bg color] 

DESCRIPTION 

Xwud is an X Window System image undumping utility. Xwud allows X users to display in a win- 
dow an image saved in a specially formatted dump file, such as produced by xwd(l). 

OPTIONS 

-bg color 

If a bitmap image (or a single plane of an image) is displayed, this option can be used to 
specify the color to display for the "0" bits in the image. 

•display display 

This option allows you to specify the server to connect to; see X(T). 

•tg color If a bitmap image (or a single plane of an image) is displayed, this option can be used to 
specify the color to display for the "1" bits in the image. 

geometry geom 

This option allows you to specify the size and position of the window. Typically you will 
only want to specify the position, and let the size default to the actual size of the image. 

-help Print out a short description of the allowable options. 

-in file This option allows the user to explicitly specify the input file on the command line. If no 
input file is given, the standard input is assumed. 

-new This option forces creation of a new colormap for displaying the image. If the image 
characteristics happen to match those of the display, this can get the image on the screen 
faster, but at the cost of using a new colormap (which on most displays will cause other 
windows to go technicolor). 

-noclick Clicking any button in the window will terminate the application, unless this option is 
specified. Termination can always be achieved by typing 'q', 'Q', or ctrl-c. 

-plane number 

You can select a single bit plane of the image to display with this option. Planes are 
numbered with zero being the least significant bit. This option can be used to figure out 
which plane to pass to ^r(J) for printing. 

-raw This option forces the image to be displayed with whatever color values happen to 
currently exist on the screen. This option is mostly useful when undumping an image 
back onto the same screen that the image originally came from, while the original win- 
dows are still on the screen, and results in getting the image on the screen faster. 

-rv If a bitmap image (or a single plane of an image) is displayed, this option forces the fore- 

ground and background colors to be swapped. This may be needed when displaying a 
bitmap image which has the color sense of pixel values "0" and "1" reversed from what 
they are on your display. 

-std maptype 

This option causes the image to be displayed using the specified Standard Colormap. 
The property name is obtained by converting the type to upper case, prepending "RGB_", 
and appending ''_MAP". Typical types are "best", "default", and "gray". See xstdcmap(l) 
for one way of creating Standard Colormaps. 

-vis vis-type-or-id 

This option allows you to specify a particular visual or visual class. The default is to pick 
the "best" one. A particular class can be specified: "StaticGray", "Grayscale", "Sta- 
ticColor", TseudoColor", "DirectColor", or "TrueColor". Or "Match" can be specified, 
meaning use the same class as the source image. Alternatively, an exact visual id 
(specific to the server) can be specified, either as a hexadecimal number (prefixed with 
'X)x") or as a decimal number. Finally, "default" can be specified, meaning to use the 
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same class as the colormap of the root window. Case is not significant in any of these 
strings. 

ENVIRONMENT 

DISPLAY 

To get default display. 

FILES 

XWDFiIe.h 

X Window Dump File format definition file. 

SEE ALSO 

xwd(l), xpr(l), xstdcmap(l), X(l) 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technolo^. 
See X(l) for a full statement of rights and permissions. 

AUTHOR 

Bob Scheifkr, MIT X Consortium 
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Using the Keyboards 



There are now two keyboards available for Hewlett-Packard workstations. Until 
now, the 46021A keyboard, also known as the "ITF" keyboard, was the only 
keyboard available. Now, in addition to the 46021A keyboard, a personal 
computer-style keyboard, C1429A, is also available. This new keyboard is also 



known as the "Enhanced Vectra" keyboard. 



Understanding the Keyboards 

If an application is reading input directly from the keyboard, it receives a 
key code when a key is pressed. Equivalent keys on the two keyboards are those 
that generate the same key code. If an equivalent key does not exist, there is no 
way to generate the corresponding keycode. 

In an X Window System environment, keycodes are mapped into key symbols 
by the X library. The key symbols are stored in a keysym table. Application 
programs then reference these key symbols when accessing keys. 
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APPUCATION 



Figure B-1. Keycap, Keycode, and Keysym Relationships 

Equivalent keys are those keys that are mapped to the same key symbol. 
One advantage of this mapping is that if a key does not physically exist on a 
keyboard, its equivalent key symbol can be mapped to some other key through 
the corresponding keycode. 



Default Keyboard Mapping 

The default keyboard mapping supplied with the X Window environment maps 
the C1429A keyboard to the same key symbols that are used for the 46021A 
keyboard. This allows existing X client programs that expect to receive input 
from a 46021A keyboard to be used with either keyboard. However, the result 
is that some keys on the C1429A keyboard are mapped to key symbols that do 
not match the engravings on their keycaps. 
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Equivalent Keys 

Some applications may expect to use keys that exist on one of the keyboards 
but not the other. In most cases, if a key does not exist on the keyboard in 
use, it is still possible to use some other key that is equivalent. To do this, it is 
necessary to know which keys are equivalent on the two keyboards. 

There are 14 keys on the C 1429 A keyboard that generate key codes equivalent 
to keys on the 46021A keyboard, but have different engravings on the keycaps. 
Some have the same key symbol on both keyboards, while others do not. These 
C1429A keys, their 46021A equivalents, and the corresponding symbol names 
are shown in the following table. 
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C1429A Keycap 


46021A Keycap 


Default Key Symbol 


XPCmodmap Symbol 


CED 


blankl 


F9 


F9 


(Flo) 


blank2 


FIO 


FIO 


(FlD 


blanks 


Fll 


Fll 


CfID 


blank4 


F12 


F12 




[Menu] 


Menu 


Print 


[PrintScreen/sysRq ] 




(Stop] 


Cancel 


Scroll-Lock 


(Scroll Lock] 






Break/Reset 


Pause/Break 


[Pause/Break J 


[Break/Reset] 




[Prev] 


Prior 


Prior 


(PajceUpJ 






System/User 


Num_Lock 


[Num Lock] 


[System /User] 


(End] 


[Select) 


Select 


End 




(Next) 


Next 


Next 


[Page Down] 






Return 


Return 


[Enter] 


[Return] 






Meta_L 


Alt_L 


[Alt (left)] 


[Extend char] (left) 






Meta_R 


Alt_R 


(AltfriKht)] 


[Extend char] (right) 
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Changing Key Mapping 

X provides the means to change the key mapping, if you so desire. One way to 
accomplish this is by running the xmodmap client program. Hewlett-Packard 
provides two files in the directory /usr/lib/Xll to use with xmodmap. One, 
XPCmodmap, causes xmodmap to change the key mapping to match the keycap 
engravings on the C1429A keyboard. The other, XHPmodmap, causes xmodmap 
to change the key mapping to match the keycap engravings on the 46021A 
keyboard, which are the defaults. This allows either keyboard to be used with 
applications that expect the other keyboard, although only one mapping can be 
used at any given time. When the mapping is changed, the X Server notifies 
all clients that are executing at that time. Some clients may load the new 
mapping from the server right away, but others may have to be restarted in 
order to recognize the new mapping. For more information about using the 
xmodmap client, see the xmodmap man page. Additional information can be 
found in chapter 9, Customizing the Mouse and Keyboard, in Using the X 
Window System. 

C1429A Keyboard 

Execute the following command to change the mapping of the keys shown 
above to match the engravings on the C1429A keycaps. 

/usr/bin/Xll/xmodmap /usr/lib/Xll/XPCmodmap 

46021A Keyboard 

Execute the following command to change the mapping to match the 46021A 
keyboard. 

/usr/bin/Xll/xmodmap /usr/lib/Xll/XHPmodmap 

Comparing the Keyboards 

The 46021A keyboard has 107 keys, while the C1429A keyboard has 101 
keys. There are 7 keys on the 46021A keyboard whose keycodes cannot be 
generated by any key on the C1429A keyboard, and whose key symbols cannot 
be generated when using the default keymap for the C1429A keyboard. The 
missing keys are: 
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Clear tine) 



Clear display j 
Insert line J 



Delete line J 



Print/Enter) 

■ (°^ number pad) 

■ [Tab) (on number pad) 

Q and (Tab) exist elsewhere on the C 1429 A keyboard, and the others are not 
needed by most applications. Applications that do need one or more of them 
must assign their key symbols to the keycodes of existing keys. The xmodmap 
client can be used to determine the keycode-to-key symbol mapping of existing 
keys, and it can also be used to assign the key symbol to the desired key code. 
These keys use HP specific key symbol names whose correct spelling can be 
found in the file /usr/lib/Xll/XKeysymDB. 
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The (Right Control) key on the C1429A keyboard generates a key code that has 
no equivalent on the 46021A keyboard. This key has the same effect as the 
(Left Control) key by default. 

Keys not mentioned above exist on both keyboards, and have the same key 
symbols. 
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Accelerator 

A key or sequence of keys (typically a modifier key and some other key) 
that provides a "shortcut," for accessing functionality. 

active window 

The terminal \/indow where what you type appears. If there is no active 
window, what you type is lost. Only one terminal window can be active at 
a time. 

application program 

A computer program that performs some useful function, such as word 
processing or data base management. 

application server 

A computer used solely to provide processing power for application 
programs. 

ampersand (&) 

Placed at the end of a command to specify that the client started by the 
command should be started as a background process. The command 
can be typed after the command-line prompt or included in a file such as 
.xl 1st art or .hpwmrc. 

background process 

A process that doesn't require the total attention of the computer for 
operation. Background processing enables the operating system to execute 
more than one program or command at a time. As a general rule, all clients 
should be run as background processes. 
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bitmap 

Generally speaking, an array of data bits used for graphic images. Strictly 
speaking, a pixmap of depth one (capable of 2-color images). 

bitmap device 

An output device that displays bitmaps. The CRT monitor of your system 
is a bitmap device. 

bitmap font 

A bitmap font is made from a matrix of dots. 

bufTer 

An area used for storage. 

button 

A button on a mouse pointing device. Mouse buttons can be mapped to the 
keyboard. 

button binding 

Association of a mouse button operation with a window manager function. 
For example, pressing button 3 on a window frame displays the system 
menu. 

button mapping 

Association of a button number with a physical mouse button. 

click 

To press and release a mouse button. The term comes from the fact that 
pressing and releasing the buttons of most mice makes a clicking sound. 

client 

A program written specifically for the X Window System. Some clients 
make their own windows. Other clients are utility programs. 

cluster 

A network of computers in which only one computer has file-system disk 
drives attached to it. 

combined mode 

A combination of image and overlay planes in which a single display has a 
single screen that is a combination of the image and overlay planes. 
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command-line prompt 

A command-line prompt shows that the computer is ready to accept 
your commands. Each terminal emulation window has a command-line 
prompt that acts just like the command-line prompt you see on the screen 
immediately after login. Usually the command-line prompt is either a $ 
(for Bourne and Korn shells) or a '/, (for C shells), but it can be modified. 
One popular modification is to print the current working directory and the 
history stack number before the $ or */,. You can find the command-line 
prompt by pressing ( Return 1 several times. Everytime you press (Return) , 
HP-UX prints the prompt. 

cut buffer 

A buffer (memory area) that holds text that has been deleted from a file. 

depth 

The number of planes in a set of planes. For example, a set of 12 image 
planes would have a depth of 12. 

diskless cluster 

The networking of several systems (SPUs) together to share a common hard 
disk for storage of data and programs. 

display 

Strictly speaking, the combination of a keyboard, mouse, and one or more 
screens that provide input and output services to a system. While "display" 
is sometimes used to mean just the CRT screen, a display, as defined here, 
can actually include more than one physical screen. 

display server 

In the X Window System, the display server is the software that controls 
the communication between client programs and the display (keyboard, 
mouse, and screen combination). 

double buffering 

A term describing the method used by Starbase wherein half of the color 
planes on a monitor are used to display to the screen and the other half are 
used to compute and draw the next screen display. This provides smooth 
motion for animation and it is faster. However, it does reduce the number 
of colors that are available for display on the screen at one time. 
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double- click 

To press and release a mouse button twice in rapid succession. 

drag 

To press and hold down a mouse button while moving the mouse on the 
desktop (and the pointer on the screen). Typically, dragging is used with 
menu selecting, moving, and resizing operations. 

file server 

A computer whose primary task is to control the storage and retrieval of 
data from hard disks. Any number of other computers can be linked to the 
file server in order to use it to access data. This means that less storage 
space is required on the individual computer. 

fonts 

A font is a style of printed text characters. Times Roman is the font used 
for most newspaper text; Helvetica is the font used for most newspaper 
headlines. 

foreground process 

A process that has the terminal window's attention. When a program is 
run in a window as a foreground process (as opposed to a background 
process), the terminal window cannot be used for other operations until the 
process is terminated. 

graphical user interface 

A form of communication between people and computers that uses 
graphics-oriented software such as windows, menus, and icons, to ease the 
burden of the interaction. 

home directory 

The directory in which you are placed after you log in. Typically, this is 
/users/ username, where username is your login name. The home directory 
is where you keep all "your" files. 

hotspot 

The area of a graphical image used as a pointer or cursor that is defined as 
the "point" of the pointer or cursor. 
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hpterm 

A type of terminal window, sometimes called a "terminal emulator 
program" that emulates HP2622 terminals, complete with softkeys. The 
hpterm window is the default window for your X environment. 

icon 

A small, graphic representation of an object on the root window (typically 
a terminal window). Objects can be "iconified" (turned into icons) to 
clear a cluttered workspace and "normalized" (returned to their original 
appearance) as needed. Processes executing in an object continue to 
execute when the object is iconified. 

iconify 

The act of turning a window into an icon. 

image mode 

The default screen mode using multiple image planes for a single screen. 
The number of image planes determines the variety of colors that are 
available to the screen. 

image planes 

The primary display planes on a device that supports two sets of planes. 
The other set of display planes is known as the overlay planes. These two 
sets of planes are treated as two separate screens in stacked mode and one 
screen in combined mode. 

input device 

Any of several pieces of equipment used to give information to the system. 
Examples are the keyboard, a mouse, or a digitizer tablet. 

keyboard binding 

Association of a special key press with a window manager function. For 
example, pressing the special keys (shift) (Esc) displays the system menu of 
the active window. 

label 

The text part of an icon. 
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local access 

The ability to run a program on the computer you are currently operating. 
This is different from remote access, where you run a program on a 
computer that is physically removed from the one you are operating. 

local client 

A local client is a program that is running on your local computer, the 
same system that is running your X server. 

mask 

A graphical image used in conjunction with another graphical elem^ent to 
hide unwanted graphical effects. 

matte 

A border located just inside the window between the client area and the 
frame. It is used to create a three-dimensional effect for the frame and 
window. 

menu 

A list of selections from which to make a choice. In a graphical user 
interface such as the X Window System, menus enable you to control the 
operation of the system. 

minimize 

To turn a window into an icon. The terms minimize and iconify are 
interchangeable. 

modifier key 

A key that, when pressed and held along with another key, changes the 
meaning of the other key. [ctrl] , (Extend char) , and (shift) are examples of a 
modifier key. 

mouseless operation 

Although a mouse makes it easy to use the X Window System, the mouse 
is not absolutely necessary. The system can be configured to run from the 
keyboard alone. 

multi-tasking 

The ability to execute several programs (tasks) simultaneously on the same 
computer. 
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node 

An address used by the system. For example, each device on the system 
has its own node. The system looks there whenever it needs to access the 
device. A node can also be an address on a network, the location of a 
system. 

non- client 

A program that is written to run on a terminal and so must be "fooled" by 
a terminal emulation window into running in the window environment. 

normalize 

To change an icon back into its "normal" (original) appearance. The 
opposite of iconify. 

overlay planes 

The secondary set of display planes on a device that supports two sets of 
planes. The other set of display planes is known as the image planes. These 
two sets of planes are treated as two separate screens. 

parent window 

A window that causes another window to appear. A window that "owns" 
other windows. 

pixel 

Short for "picture element." The individual dots, or components, of a 
screen. They are arranged in rows and columns and form the images that 
are displayed on the screen. 

pixmap 

An array of data bits used for graphics images. Each pixel (picture element) 
in the map can be several bits deep, resulting in multi-color graphics 
images. 

pointer 

Sometimes called the "mouse cursor," the pointer shows the location of the 
mouse. The pointer's shape depends on its location. In the root window, 
the pointer is an X . On a window frame, the pointer is an arrowhead. 
Inside the frame, the pointer can be an arrowhead (as when it is inside a 
clock or load histogram frame) or an I-beam (as when it is inside a terminal 
window). 
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press 

Strictly speaking, to hold down a mouse button or a key. Note that to hold 
down a mouse button and move the mouse is called "dragging." 

print server 

A computer that controls spooling and other printer operations. This 
permits a large number of individuals to efficiently share printer resources. 

remote access 

The ability to run a program on a computer that is physically removed 
from the one you are currently operating. This is different from local access, 
where you run a program on the computer that you are operating. 

remote client 

An X program that is running on a remote system, but the output of the 
program can be viewed on your terminal. 

remote host 

A computer physically removed from your own that you can log in to. See 
chapter 4 for prerequisites for establishing a remote host. 

resource 

That which controls an element of appearance or behavior. Resources are 
usually named for the elements they control. 

restoring 

The act of changing an minimized (iconified) or maximized window 
back to its regular size. The terms restoring and normalizing are usually 
interchangeable. 

root menu 

The menu associated with the root window. The root menu enables you to 
control the behavior of your environment. 

root window 

The root window is what the "screen" (the flat viewing surface of the 
terminal) becomes when you start X. To a certain extent, you can think 
of the root as the screen. The root window is the backdrop of your X 
environment. Although you can hide the root window under terminal 
windows or other graphic objects, you can never position anything behind 
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the root window. All windows and graphic objects appear "stacked" on the 
root window. 

scalable fonts 

Scalable fonts are defined by a file containing a mathematical outline used 
by the system to create a bitmapped font for a particular size, slant, or 
weight. 

screen 

The physical CRT (Cathode Ray Tube) that displays information from the 
computer. 

screen dump 

An operation that captures an image from your screen, saves it in a file, and 
enables you to send that file to a printer for hardcopy reproduction. 

server 

A program that controls all access to input devices (typically a mouse and a 
keyboard) and all access to output devices (typically a display screen). It is 
an interface between application programs you run on your system and the 
system input and output devices. 

stacked mode 

A combination of image and overlay planes in which a single display has 
two "logical" screens, one the image planes, the other the overlay planes. 
Typically, the image planes are used to display graphics while the overlay 
planes are used to display text. 

system menu 

The menu that displays when you press the system menu button on the HP 
Window Manager window frame. Every window has a system menu that 
enables you to control the size, shape, and position of the window. 

TermO 

An HP level terminal. It is a reference standard that defines basic 
terminal functions. For more information, see TermO Reference in the 
HP-UX documentation set. 
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terminal-based program 

A program (non- client) written to be run on a terminal (not in a window). 
Terminal-based programs must be "fooled" by terminal-emulation clients to 
run on the X Window System. 

terminal emulator 

A client program that provides a window within which you can run 
non- client programs. The non- client program runs just as though it were 
running from a real terminal rather than a window acting as a terminal. 

terminal type 

The type of terminal attached to your computer. HP-UX uses the terminal 
type to set the TERM environment variable so that it can communicate with 
the terminal correctly. The terminal type is usually set at login, but can be 
set afterward. 

terminal window 

A terminal window is a window that emulates a complete display terminal. 
Terminal windows are typically used to "fool" non- client programs into 
believing they are running in their favorite terminal — not a difficult task in 
most cases. When not running programs or executing operating system 
commands, terminal windows display the command-line prompt. Two 
terminal windows are supplied with Xll— hpterm, which emulates HP 
terminals, and xterm, which emulates DEC and Tektronix terminals. 

text cursor 

The line-oriented cursor that appears in a terminal window after the 
command prompt. The term is used to distinguish the cursor used by a 
window from the cursor used by the mouse, the pointer. 

tile 

A rectangular area used to cover a surface with a pattern or visual texture. 
The HP Window Manager supports tiling, enabling users with limited color 
availability to create new color tiles blended from existing colors. 

title bar 

The title bar is the rectangular area between the top of the window and the 
window frame. The title bar contains the title of the window object, usually 
"Terminal Emulator" for hpterm windows, "xclock" for clocks, and "xload" 
for load histograms. 
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transient window 

A window of short duration such as a dialog box. The window is only 
displayed for a short time, usually just long enough to get some direction 
from the user. 

window 

A data structure that represents all or part of the CRT display screen. 
It contains a two-dimensional array of 16-bit character data words, a 
cursor, a set of current attributes, and several flags. Visually, a window is 
represented as a rectangular subset of the display screen. 

window-based program 

A client or program written for use with the X Window System. The 
"opposite" of a window-based program is a terminal-based program. 

window decoration 

The frame and window control buttons that surround windows managed by 
the HP Window Manager. 

window manager 

The window manager controls the size, placement, and operation of 
windows on the root window. The window manager includes the functional 
window frames that surround each window object as well as a menu for the 
root window. 
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Special characters 

$@, 4-3 

&, 8-1, Glossary- 1 

*, 5-9, 6-7 

*, 3-7 

?, 6-7 

@, 7-26 

_,6-7 



accelerators, 2-5, 7-26, Glossary- 1 
access 

remote, Glossary-8 
activating a window, 4-14 
activeColorSetId resource, 5-10 
active window, 2-2, 4-9, 7-40, Glossary- 1 
adding 

font directories, 6-4 

frame elements, 7-6 

resources, 5-5 
administrative directories, 6-32 
Aegis, 3-6 

alias name, 6-2, 6-5, 6-7, 6-15 
app-defaults, 3-9, 5-1, 5-2, 6-13 
application program, Glossary- 1 
applications 

CAD, 2-5 

graphics, 2-5 

obtaining resources, 5-1 

process-intensive, 2-4 

servers, 2-4 

stopping, 4-25 



application server, 2-4 
aurchive directory, 6-32 

B 

background 

color, 8-2 

processing, 8-1 
• bdl file extension, 6-19, 6-32 
bdftosnf program, 6-19, 6-19, 6-21, 

8-10, 8-11 
bell volume 

changing with xset, 8-19 
bindings, default, 7-34 
bitmap, Glossary-2 
bitmap client, 8-10, 8-13 
bitmap device, 2-7, Glossary-2 
bitmapped font, Glossary-2 
bitmapped fonts, 6-1, 6-14 

adding, 6-18 

deleting, 6-19 

directory, 6-17 
bitmaps, 7-26 
borrow mode server, 2-8 
bottom menu selection, 4-20 
BSD, 3-6 

buffer, 11-3, Glossary-2, Glossary-3 
buttons 

actions, 9-1 

binding, Glossary-2 

bindings, 7-31, 7-33, 7-34 

changing mappings, 9-3 

click timing, 7-34 
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cording, 9-10 

locations, 1-4 

mapping, Glossary-2 

mapping functions, 9-8 

mappings, 9-3 

maximize, 4-13 

minimize, 4-13 

mouse, 4-12, 9-1, 9-6, Glossary-2 

operation functions, 9-8 

window menu, 4-13 



cached clients, 8-6 

CAD applications, 2-5 

capital letters, 1-4 

capturing windows, 10-2 

case sensitivity, 1-4 

changing. See modifying 

character sets, 6-12, 6-22, 6-27 

chELTsets directory, 6-32 

char sets.dir file, 6-25, 6-28, 6-32 

chording, 9-10 

class defaults, 5-1 

classes 

clients, 5-7 

resources, 5-8 
clicking mouse button, 4-12, Glossary-2 
clients, 2-2, 4-3, 4-7 

classes, 5-7 

colors, 5-10 

configuration, 8-7 

definition, Glossary-2 

display option, 8-3 

graphics functions, 8-8 

initialization, 8-7 

matting, 7-11 

names, 5-7 

remote, 8-4, Glossary-8 

root window, 4-8 

starting, 4-3, 8-4 

stopping, 4-25 



syntax of resources, 5-7 

using fonts, 6-13 

viewable services, 8-10 

window management, 8-8 
clients, graphics, 11-9 
CLIPBOARD, 8-33, 8-37 
CLIPBOARD clipboard buffer, 8-32 
close menu selection, 4-20 
closing windows, 4-26 
cluster, Glossary-2 
cluster, diskless, 2-4 
color, 5-10 

database, 8-23 

names, 5-10 

options, 5-10 

reversal, 10-7 

rgb specifications, 5-10 

setting, 5-10 

using hexadecimal values, 5-10 
colorable elements, 5-10 
color images, printing, 10-8 
coloring 

frame elements, 7-7 

matte elements, 7-11 
colormap, 8-26 
colormap focus policies, 7-41 
COLUMNS environment variable, 8-27 
combined mode, 3-10, 3-14, 11-3, 
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command line, 4-2, 5-1, 5-3, Glossary-3 

options, 8-2 

syntax, 8-1, 8-2 
commented resources 

syntax, 5-6 
compress font format, 6-19 
computer hardware, 2-6 
configuration 

clients, 8-7 

files, 3-9 

special, 3-7 
contexts for keyboard bindings, 7-37 
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controlling communication, 2-8 

controls, window manager, 4-9 

conventions, 1-3 

conversion utilities, 11-14 

corner pieces, 4-13 

csh shell, 3-6 

cursor, 4-13, 8-17, Glossary-10 

bitmap, 8-17 

creating, 8-17 

mask, 8-17 
custom behavior, disabling, 7-41 
custom pixmaps, 7-18 
cut and paste, 8-9, 8-32 
cutbufFer, 8-32, 8-35, 8-37, Glossary-3 



DCE, 2-3 

declaring resources, 7-3 

default 

behavior,switching to, 7-41 

button bindings, 7-31 

class specific, 5-1 

display number, 4-3 

files, 4-9 

keyboard bindings, 7-34 

resource files, 4-2 

root menu, 4-21, 7-25 

screen configuration file, 3-7 

server, 4-4 

window menu, 7-24 

XOdevices configuration, 9-4 
destroying a window, 11-11 
device 

driver file, 3-15 

file name syntax, 3-20 

input, 3-17, Glossary-5 

reconfiguring path, 3-20 
disc space, 6-30 

diskless clusters, 2-4, 2-6, Glossary-3 
diskless workstations, 2-4 
disks, hard, 2-6 



display, 2-7, 8-2, Glossary-3 

multiple, 4-4 

options, 8-3 

pixmap for monochrome, 7-9 

planes, 11-3 

preferences, 8-19 

server, 2-8 

specifying, 8-3 
display devices, multiple, 3-15 
DISPLAY environment variable, 3-2, 3-5, 

4-11, 8-3 
displaying fonts, 6-2 
Display Manager, 4-26 
DISPLAYS device, 6-27 
dmtox client, 8-7 

Domain operating system, 2-8, 3-2, 3-3, 
3-6, 3-7, 3-10, 3-18, 3-23, 4-3, 4-5, 
4-26, 6-21, 8-7 
double buffering, 11-3 
double-clicking mouse button, 4-12, 
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dragging mouse button, 4-12, Glossary-4 
dumb windows, 11-7 
Dvorak keyboard, 9-20 



editing 

button bindings, 7-33 

button click timing, 7-34 

keyboard bindings, 7-37 

menus, 7-25, 7-30 
end functions, 7-30 
environment variable, 3-24, 3-25, 3-26, 

3-27, 8-3 
environment variables, 3-5, 5-1, 8-27 

supplying resources, 5-1 
ENVIRONMENT variables, 4-8 
/etc/hosts file, 3-2, 3-8 
etc/sys.conf file, 4-7 
exiting 

clients, 4-25 
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programs, 8-6 
window system, 4-25 
explicit focus policy, 7-41 



file server, 2-4, Glossary-4 
focus policies, 7-40, 7-41 
font, Glossary-4 

administrator, 6-21 

bitmap, Glossary-2 

bitmapped, 6-1 

character set, 6-12 

converting formats, 6-32 

definition, 6-1 

directories, 6-31, 6-35 

displaying, 6-2 

error messages, 6-17 

file name, 6-14 

formats, 6-19, 6-32 

listing, 6-5 

metrics, 6-31 

native language, 6-35 

option, 8-2 

products, 6-31 

resources, 5-12 

scalable, Glossary-9 

scalable typeface, 6-1 

search path, 6-4, 6-15, 6-16 

wild cards, 6-14 
font compiler. See bdftosnf 
font format, 6-19 
fonts. alias file, 6-4, 6-7, 6-13, 6-15, 

6-16, 6-31 
fonts directory, 6-35 
fonts.dir file, 6-5, 6-7, 6-13, 6-13, 

6-14, 6-15, 6-19, 6-25, 6-31 
foreground 

color, 8-2 
frames, 4-13, 7-5, 7-6, 7-7, 7-9 
functions, 7-25, 7-27 



geometry, 5-10, 8-2 
graphical user interface, Glossary-4 
graphics accelerators, 2-5 
graphics functions clients, 8-8 
graphics station, described, 2-5 
gwind client, 8-8, 11-9 
gwindstop client, 8-8, 11-9, 11-12 

H 

hard disk, 2-6 

hardware, 2-6 

help option, 8-2 

hexadecimal color values, 5-10 

histogram. See xload 

home directory, Glossary-4 

host 

environment, 5-1 

names, 3-8 

remote, Glossary-8 
hosts, 8-26 
hosts. dir file, 6-31 
hotspot, 8-17, 8-18, Glossary-4 
HP-HIL devices, 2-7, 3-18 
HP-HIL interface, 3-18, 3-19 
hpterm, 2-10, Glossary-5 
hpterm client, 4-3, 8-10, 8-11, 8-32, 8-35 
HP-UX operating system, 2-4, 2-7, 2-8, 
3-3, 3-6, 3-18, 3-19, 3-23, 4-3, 4-4, 
4-26, 6-21, 8-7, 11-9 
HP Windows/9000, 4-2 

I 

icon box, 7-19, 7-20 

keyboard focus, 7-22 

minimizing, 7-20 

placing icons in, 7-22 

specifying, 7-20 
iconifying, 4-22, 4-23, Glossary-5 
icons 

appearance, 7-14, 7-16, 7-17 
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behavior, 7-16 

coloring, 7-19 

definition. Glossary- 5 

image, 7-15 

label, 7-14 

menu, 4-24 

normalizing, 4-22, 4-23 

placement, 4-23, 4-24, 7-15 

resources, 7-15 

selecting, 4-24 

sizing, 7-17, 7-18 

tiling, 7-19 
.ifo file extension, 6-31, 6-32 
if O.St file, 6-31 

image mode, 3-10, 3-14, 11-3, Glossary-5 
image planes, 11-3, Glossary-5 
images, 7-15, 10-7 
inactiveColorSetId resource, 5-10 
initialization clients, 8-7 
input devices, 2-6, 2-8, 3-17 
installing typefaces, 6-23 
interaction model, server- client, 2-1 
interface, HP-HIL, 3-18 
interface, RS-232, 3-18 
interface, serial, 3-18 
interfaces, graphical, 1-1 

K 

KBD_LANG environment variable, 3-26, 

6-35 
key 

bindings, 7-34, 9-16 

map, 9-20 

names, 9-12 

remapping expressions, 9-18 
key Bindings resource, 7-36 
keyboard, 9-6 

46021A, 9-16, B-1 

assigning mouse functions, 9-6 

binding, Glossary-5 

bindings, 7-36 



C1429A, 9-16, B-1 

Dvorak, 9-20 

focus, 7-22, 7-41 

input, 9-16 

input devices, 2-6 

input directed by mouse, 4-10 

modifier keys, 9-10 

modifier names, 9-18 

special keys, 7-34 

using, 7-34 
keyboard, 46021A, 2-6 
keyboard, C1429A, 2-6 
killing 

processes, 8-6 

programs, 8-6 
ksh shell, 3-6 



label, 7-14, Glossary-5 

LAN, 2-3, 2-7 

LANG environment variable, 3-24, 3-25 

language-dependent resources, 5-1 

license 

adding, 6-26 
licenses directory, 6-31 
licensing typefaces, 6-23, 6-26 
LINES environment variable, 8-27 
listing fonts, 6-5 
local 

access, 2-3, Glossary-6 

area network(LAN), 2-7 

client, Glossary-6 

clients, 8-4 

processing, 2-4 

programs, 2-3 
location. See placement 
location of windows, 5-10 
logging into a remote host, 8-4 
loopback address, 3-8 
lowercase letters, 1-4 
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M 

manual conventions, 1-3 
manuals, reference, 1-5 
mapping 

functions, 9-8 

mouse buttons, 9-3 
mask, 8-17, Glossary-6 
mattes, 7-11, Glossary-6 
maximize 

button, 4-13 

menu selection, 4-20 
menus, Glossary-6 

accelerators, 7-26 

button, 4-13 

changing, 7-30 

default, 7-24 

greyed out entries, 7-27 

managing, 7-24 

mnemonics, 7-26 

root, Glossary-8 

system, Glossary-9 

titles, 7-26 

window, 7-31 

window manager, 7-24 
merging resources, 5-5, 5-6 
message catalogs — the NLSPATH 

environment variable, 3-25 
metrics subdirectory, 6-31 
minimize, Glossary-6 

button, 4-13 

definition, 4-22 

menu selection, 4-20 
mkfontdir program, 6-4, 6-13, 6-18, 

6-19, 8-10, 8-11 
mknod command, 3-15 
mnemonics, 4-20, 7-26 
mode 

combined, 3-10 

image, 3-10 

overlay, 3-10 

screen, 3-10, 11-3 



stacked, 3-10 
modifier 

key, Glossary-6 

key bindings, 9-16 

keys, 9-10 

names, 9-18 
modifying 

button bindings, 7-33 

button click timing, 7-34 

functions, 7-25 

keyboard bindings, 7-37 

menus, 7-25, 7-30 

window frame pixmap, 7-9 

window size, 4-16 

XOpointerkeys, 9-5 
monochrome display, 7-12, 7-13 
mouse, 2-7 

alternatives to, 2-7 

button, 9-3 

button bindings, 7-31 

button locations, 1-4 

button mappings, 9-2 

buttons, 4-12, 9-1, 9-6 

displaying root menu, 4-20 

functions, 9-6 

keys, 9-10 

moving icons, 4-24 

moving windows, 4-15 

operations, 4-12, 7-31 

pointer and active window, 4-10 

tracking, 3-15 

using, 7-31 

without, 2-6, 9-4, Glossary-6 
mouseless operation, 9-4 
move menu selection, 4-20 
moving 

icons, 4-24 

images on paper, 10-7 

windows, 4-15 
multi-display system, 4-4 
multiple display devices, 3-15 
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multiple screen devices, 3-15 
multiple screens, 3-13, 7-42 
multi-seat, 4-4 
multi-tasking, 2-2, 2-8, Glossary-6 

HP-UX, 2-4 
multi-vendor 

communications, 2-5 
mwm_bw entries in .Xdefaults, 7-13 
.mwmrc file, 3-9, 4-2 
mwm window manager, 2-9, 4-3, 4-9, 
4-12, 7-5, 7-13, 7-27, 7-42 

N 

naive windows, 11-7 
names 

clients, 5-7, 5-8 

resources, 5-8 
native language, 3-24 
native language fonts, 6-35 
networked computing, 2-3 
new window, 4-21 
NFS, 6-32 
NL I/O, 6-35 

fonts, 6-35 
NLS environment variables, 3-25 
NLSPATH environment variable, 3-25 
node, Glossary- 7 

definition, 2-4 
non-clients, 2-2, 8-1, 8-5, Glossary-7 
normalizing, 4-23, Glossary-7 



operating system, 2-4, 2-8. See also 
Domain operating system, HP-UX 
operating system, OSF/1 operating 
system 
operation functions, 9-8 
options 

command line, 5-1, 8-2 
command-line syntax, 8-2 
display, 8-3 



toolkit, 8-2 
OSF/1 operating system, 2-7, 2-8, 3-2, 

3-3, 3-6, 3-7, 3-18, 3-19, 3-23, 4-3, 

4-26, 6-21, 8-4, 8-7, 11-9 
OSF/Motif Window Manager, ^ee mwm 
overlay mode, 3-10, 3-14, 11-3 
overlay planes, 11-3, Glossary-7 



Packlcons, 7-22 

PaintJet, 10-8 

parent window, Glossary-7 

patterns, 7-9 

PCLEO font format, 6-32 

PCL font format, 6-32 

personal resources, 5-1, 7-3, 7-16, 7-31 

PID, 8-6 

pixels, 4-15, Glossary-7 

pixmaps, 7-9, 7-11, 7-18, Glossary-7 

placement 

icons, 7-15 

of icons, 4-23 

window, 7-37 
planes 

image, overlay, 11-3 
pointer, 2-7, 4-13, Glossary-7 

and keyboard input, 4-10 

custom, 8-17 

direction keys, 9-6 

distance functions, 9-7 

focus policy, 7-41 

key names, 9-12 

movement functions, 9-6 

specifying keys, 9-12 
pointing device, 2-7 
position resources, 7-37 
precedence 

icon images, 7-15 

resources, 5-8 
pressing mouse button, 4-12, Glossary-J 
PRIMARY, 8-32, 8-35, 8-37 
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PRIMARY clipboard buffer, 8-32 
primary ColorSetId resource, 5-10 
printers, 10-7 
PRINTERS device, 6-27 
printing 

color images, 10-8 

key map, 9-20 

screen dumps, 10-5 
print server, 2-5, Glossary- 8 
process 

background, Glossary- 1 

foreground, Glossary-4 

ID, 8-6 

-intensive applications, 2-4 

killing, 8-6 
processing 

local, 2-4 

remote, 2-4 
products. dir file, 6-31 
products subdirectory, 6-31 
programs 

remote and local, 2-3 

running, 2-3 

setting colors, 5-10 

stopping, 4-25, 8-6 

terminal-based, 2-10 
prompt, 4-13 
pulldown menu, 4-19 



raising a window, 4-17 
raw mode, 11-12 
redrawing the screen, 8-28 
reference books, 1-5 
reference manuals, 1-5 
reference XLFD name, 6-7, 6-14 
refining control, 7-37 
refresh, 4-21 
remapping, 9-16, 9-18 
remote 

access, 2-3, Glossary-8 



clients, 8-4, Glossary-8 

host, 8-4, Glossary-8 

processing, 2-4 

programs, 2-3 
removing 

font directories, 6-4 

frame elements, 7-6 

graphics litter, 8-28 
remsh command, 8-4 
repainting the screen, 8-28 
request XLFD name, 6-7, 6-11, 6-14 
reset functions, 9-8 
resize client, 8-8, 8-27 
resizing 

borders, 4-13 

images on paper, 10-7 

windows, 4-16 
resolved XLFD name, 6-7 
resource 

definition, Glossary-8 

files, 3-9, 5-6 
RESOURCE_MANAGER property, 

5-1, 5-3, 5-6 
resources 

adding, 5-6 

app-defaults, 5-2 

by client class, 5-7 

by client name, 5-7 

changing, 5-3 

classes, 5-8 

client, 5-1 

client-specific, 7-42 

color, 5-10 

coloring icons, 7-19 

color set, 5-10 

commented, 5-6 

controlling, 7-40 

focus policy, 7-40 

font, 5-12 

geometry, 5-10 

how acquired by a client, 5-1 
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icon box, 7-20 

icon placement, 7-15 

icon size, 7-18 

icon tiling, 7-19 

matte, 7-11 

merging, 5-5, 5-6 

mwm, 7-42 

names, 5-8 

precedence, 5-8 

size, 7-37 

supplied by command line, 5-1 

syntax, 5-6 

wild cards, 5-9 

window control, 7-37 

window decoration, 7-6 

window frame, 7-7, 7-9 

window frame, coloring, 7-11 

window frame, monochrome, 7-12 
restart, 4-21 

restore menu selection, 4-20 
restoring, 4-23, Glossary-8 
reversing colors, 10-7 
rgb client, 8-7, 8-11, 8-23 
rgb.txtfile, 8-24 
rgb values, 5-10 
rlogin command, 8-4 
root cursor, 8-18 
root menu, Glossary-8 

default, 7-25 

displaying, 4-20 

selecting, 4-20, 4-21 
root window, 2-7, 4-8, 8-18, Glossary- 
clients, 4-8 

root menu, 4-20 

with terminal window, 4-9 
RS-232 interface, 3-18 
rsh command, 8-4 



sample screen configuration, 3-14 
sb2xwd command, 8-8, 8-11, 11-14 



scalable typefaces, 6-6, 6-8, 6-9, 6-10, 
6-11, 6-14, 6-21 

definition, 6-1 

deleting, 6-24 

directories, 6-31 

installing, 6-23 
.scf file extension, 6-18, 6-19, 6-32 
screen, Glossary-9 

configurations, 3-10 

default configuration, 3-10 

default configuration file, 3-7 

depth, 11-5, Glossary-3 

dumps, 10-1, 10-2, 10-3, 10-5, 
Glossary-9 

mode, Glossary-2 

modes, 3-10, 11-3 

multiple, 3-13, 3-15, 4-4 

repainting, 8-28 

specifying, 8-3 
seat, 4-4 

SECONDARY clipboard buffer, 8-32 
secondaryColorSetId resource, 5-10 
selection buffers, 8-32 
serial interface, 3-18 
server, 2-1, 2-8, 4-3, Glossary-1, 

Glossary-9. See also Xapollo server, 
Xdomain server 

application, 2-4 

file, 2-4 

print, 2-5 

starting, 4-3 

starting for Starbase, 11-7 

starts root window, 4-8 

X, 2-1 
server-client interaction model, 2-1 
server operating modes, 11-3 
share mode server, 2-8 
sh shell, 3-6 
shuflfle windows, 4-21 
size 

changing for windows, 4-16 
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menu selection, 4-20 

resources, 7-37 

specification, 5-10 

window, 5-10, 7-37 
sizing icons, 7-17 
smart windows, 11-7 
.Slit file extension, 6-18, 6-19, 6-21, 

6-32 
special configurations, 3-7 
special input devices, 3-17 
specifying 

fonts, 7-13 

icon colors, 7-19 

icon tile, 7-19 
SPU, described, 2-6 

stacked mode, 3-10, 3-14, 11-3, Glossary-9 
stadmin program, 6-32 
Starbase, 3-14 

applications, 11-7 

format conversion, 11-14 

killing windows, 11-12 

operating modes, 11-3 

running in raw mode, 11-12 

transparent windows, 11-13 

X*screens file, 11-1 
starting 

client options, 4-3 

clients, 8-4 

clock, 4-21 

load, 4-21 

multi-seat systems, 4-4 

problems, 4-10 

remote non-clients, 8-5 

server options, 4-3 

X, 4-2, 4-8 
stconv program, 6-34 
stdout file, 6-34 
. St file extension, 6-31 
sticky menu, defined, 4-19 
stlicense program, 6-22, 6-26 
stload program, 6-22, 6-23, 6-24 



stmkdirs program, 6-19, 6-22, 6-24, 

6-25, 6-28, 6-31 
stmkf ont program, 6-11, 6-32, 6-32 
stopping 

clients, 4-25 

non- clients, 8-5 

programs, 8-6 

window system, 4-25 
STSYSTEM directory, 6-31 
STSYSTEM host, 6-27 
symbol sets, 6-34 
. sym file extension, 6-32, 6-34 
syntax 

colors, 5-10 

command-line, 8-1 

command-line options, 8-2 

device file name, 3-20 

device type and relative position, 
3-19 

display, 8-3 

geometry, 5-10 

hpwm resource, 7-26 

mwm resource, 7-2, 7-25, 8-27, 8-29, 
8-30 

resources, 5-6, 7-3 
system default files, 3-9 
system directories, 3-9 
system directory, 3-3, 6-13, 6-35 
system menu, Glossary-9 
system.mwinrc file, 3-9 
system processing unit, 2-6 
SysV, 3-6 

sy s.xl 1st 2urt file, 3-9 
sys . Xdef aults file, 5-3, 7-3, 7-14 



tablet size, 9-10 

termO, Glossary-9 

TERM environment variable, 8-27 

terminal 

-based program, Glossary-10 
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emulation, 2-9, 2-10, 8-5, 8-11 

emulator, Glossary- 10 

type. Glossary- 10 

window. Glossary- 10 
terminal window, 4-9 
text cursor, 4-10 

.tfm file extension, 6-25, 6-31, 6-32 
threshold functions, 9-8 
tiling, 7-9, 7-11, 7-19, Glossary-10 
timing, button click, 7-34 
tips, 1-4 

title bar, 4-13, Glossary-10 
titles,menu, 7-26 
toolkit options, 8-2 
tracking with multiple screen devices, 

3-15 
transferring information, 8-32 
transient window. Glossary- 11 
transparent 

background color, 11-13 

windows, 11-12, 11-13 
troubleshooting, 4-7, 4-10 
typefaces.dir file, 6-31, 6-32 
type styles. See fonts 
typographical conventions, 1-3 
typographical tips, 1-4 

U 

uncompress font format, 6-19 
uppercase letters, 1-4 
/usr/lib/Xll directory, 3-3, 4-4 
/usr/Xll/lib directory, 3-3 
utilities, 8-30 



viewable services clients, 8-10 
viewing screen dumps, 10-2 

W 

wild cards, 5-9, 6-6, 6-7 
window, Glossary- 11 



active, 2-2, 4-9 

based program, Glossary- 11 

capturing, 10-2 

changing to icons, 4-22 

closing, 4-26 

control, 7-37 

decoration, 7-6, Glossary-11 

frames, 4-12, 4-13, 7-6 

management clients, 8-8 

manager, 2-8, 4-9, 4-12, 7-5, 7-13, 
7-24, 7-27, 7-30, Glossary-11 

managing, 7-1 

moving, 4-15 

-naive (dumb) programs, 11-7 

parent, Glossary-7 

placement, 7-37 

raising, 4-17 

removing, 4-25 

resizing, 4-16 

root, 4-8, Glossary-8 

setting colors, 5-10 

size, 7-37 

size and location, 5-10 

-smart programs, 11-7 

system, 4-25 

terminal, Glossary-10 

terminal emulation, 2-9 

transient, Glossary-11 

transparent, 11-12 
window frames. See frames 
window manager functions. See functions 
window menu 

button, 4-13 

changing, 7-31 

default, 7-24 

description, 4-13 

displaying, 4-14 

icon box, 7-22 

resize window, 4-16 

selecting from, 4-14 

selections, 4-20 
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windows, 1-1 
Windows/9000, 4-2 
workspaces, 2-7 



XOdevices file, 3-17, 4-4, 9-4 

XO. hosts file, 3-2, 3-7 

XOscreens file, 3-7, 3-10, 3-14, 3-15, 

4-4, 9-4, 9-5 
XI 1 clients. See clients 
XI 1 non-clients. See non-clients 
.xllstart file, 3-9, 4-2, 4-3, 4-8, 4-11 
xllstart script, 4-2, 4-4, 4-8, 4-11 
Xapollo server, 2-8, 4-5 
XAPPLRESDIR environment variable, 

5-1 
XBMLANGPATH environment variable, 

3-27 
X clients, 2-9, 8-1 
xclipboard buffers, 8-32 
xclipboard client, 8-9, 8-32, 8-33, 8-35, 

8-37 
xclock client, 8-10, 8-12 
xcutsel client, 8-9, 8-32, 8-35, 8-37 
.Xdefaults file, 3-9, 4-2, 5-1, 5-3, 7-3 
.Xdefaults-host file, 5-1 
X*devices file, 3-17, 3-18, 3-19, 3-21, 

4-4, 9-4 
Xdomain server, 2-8, 3-18, 4-5, 4-26 
XENVIRONMENT environment 

variable, 5-1 
xld client, 6-2, 8-10 
xhost client, 8-7, 8-26 
X*. hosts file, 3-7 

XHPSetKeyboaordMapping resource, 6-35 
xinit client, 4-8, 8-7 
xinitcolormap client, 8-7, 8-26 
XLFD extensions, 6-7 
XLFD name, 6-2, 6-5, 6-6-13, 6-13, 

6-14, 6-15, 6-16, 6-17, 6-31, 6-32 
XLFD wild cards, 6-7, 6-8 



xload client, 8-10, 8-11, 8-12 

xlsf onts program, 6-5, 6-6, 6-7, 6-17, 

8-10 
xmodmap client, 8-7, 9-3, 9-16, 9-18, 9-20 
X*pointerkeys file, 4-26, 9-4, 9-5, 9-10 
xpr command, 8-8, 8-11, 10-5, 10-7, 

10-8 
xrdb client, 5-1, 5-3, 5-4, 5-5, 5-6, 8-7 
xrelresh client, 8-8, 8-28 
X*screens file, 3-7, 3-10, 3-10, 3-10, 
3-13, 3-14, 3-15, 3-17, 4-4 

with Starbase, 11-1 
xseethm client, 8-8, 11-13 
X server, 2-1, 2-8, 6-4, 6-11, 6-14, 6-15, 
6-16, 6-18, 6-19, 6-26. See also 
server 
Xserver server, 8-7 
xset client, 6-4, 6-14, 6-16, 6-17, 6-18, 

6-19, 6-22, 8-7, 8-19 
xsetroot client, 8-10, 8-18, 8-18, 11-13 
X, starting, 4-2 
xterm client, 4-3, 8-10, 8-11 
XUSERFILESEARCHPATH, 3-26 
xwcreate client, 8-8, 11-9, 11-9 
xwd2sb command, 8-8, 8-11, 11-14 
xwd client, 8-8, 10-2, 10-2, 10-7 
xwdestroy client, 8-8, 11-9, 11-11 
xwd format, 11-14 
X Window System, 4-2, 4-26 

basics, 2-1, 4-1 

common features, 2-6 

configuration, 3-1 

configuring, 3-22 

hardware, 2-6 

reference books, 1-5 

software, 2-8 

start problems, 4-10 

stopping, 4-25 
xwininlo client, 8-8, 8-30 
xwud client, 8-8, 10-2, 10-4 
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